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Introducao 


Este livro € seu guia para o computador Apple I|. Ele descreve o Apple I! e cobre os periféricos 
mais comuns e acessorios, incluindo drives de disco e impressoras. 

Assumimos que vocé tenha acesso a um sistema com o Apple I! completamente instalado 
de acordo com as instrucdes do manual do proprietério que vem junto com o equipamento. Ele 
nao explica como instalar o sistema, mas como usa-lo apos a instalacao. 

O que é um Apple II? Como se faz para que ele funcione? Os primeiros dois capitulos res- 
pondem a esta questao. Vocé provavelmente ja deve saber que o APPLE II é feito a partir de muitas 
partes colocadas juntas com fios e cabos. O primeiro capitulo diz o que é cada peca e para que 
serve. O segundo capitulo diz como operar cada parte do equipamento. Com esse conhecimento 
vocé estarad pronto para utilizar qualquer um dos pacotes de software prontos-para-uso, extensa- 
mente disponiveis para processamento de palavra, andlise financeira, contabilidade doméstica, 
instrug¢ao programada por computador e entretenimento. 

Os quatro capitulos seguintes informam como executar seus proprios programas em BASIC 
no Apple II. O terceiro capitulo inicia com um arranjo tutorial de ambas as versdes de BASIC 
disponfveis para o Apple II, Integer BASIC e Applesoft. O quarto capitulo continua o BASIC com 
abordagem de topicos mais avancados de programacdo e outras propriedades do BASIC. Dois dos 
topicos avancados, o drive de disco e os graficos em video sao bastante importantes e a eles foram 
destinados capitulos especiais. O quinto capitulo explica como usar o drive de disco para guardar 
arquivos de dados e programas. O sexto capitulo ensina como programar graficos usando o video 
display pelas duas formas graficas disponiveis no Apple II. 

Os programas em BASIC operam no Apple I! sob a supervisdo de seu Monitor. O sétimo 
capitulo explica tanto o Monitor standard como o Autostart sob o ponto de vista da programacao 
BASIC. O capitulo também fornece informacao de como incorporar rotinas em linguagem assem- 
bler dentro do programa em BASIC. 

O oitavo capitulo contém uma descricado completa de cada comando e func¢ao disponiveis 
em ambas as versoes do BASIC, incluindo comandos de disco. Juntamente com os apéndices, ele 
funciona como uma referéncia imediata, uma vez que ja se saiba programar em BASIC no Apple II. 


Apresentando o Apple Il 


A Figura 1.1 mostra a configura¢ao tipica de um sistema de computador com o Apple II. Veja que 
o sistema é composto de varias partes separadas que compdem o equipamento. 

Seu sistema particular pode nado ser exatamente o que esta mostrado na figura. Muitos com- 
ponentes vém de uma grande lista de dispositivos opcionais. Porém existem trés elementos que 
todes os sistema tém em comum:o proprio Apple ||, o teclado conjugado e o televisor. Vamos dar 
uma olhada em cada um deles e nos dispositivos opcionais mais comuns. Nao vamos ensinar como 
ligar esses componentes no Apple II. Para as instrug¢des sobre instalagao completa, veja os manuais 
de usuario fornecidos com cada componente. 





FIGURA 1.1. Um Sistema de Computacao Tfpico do Apple I1. 
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TECLADO E TV 


O teclado e a tela de TV tornam a comunicacdéo com o Apple I! possivel. Um teclado padrao do 
tipo de maquina de escrever vem com o Apple II. Ele transfere as instrucdes tecladas para dentro 
do computador. 

A tela de TV pode ser tanto uma televisdo colorida comum quanto um monitor em cores. 
Uma TV em preto e branco também funciona, mas é claro que a informacao no video se torna 
mais pobre do que em cores. A tela nao apenas repete aquilo que é teclado de forma a se poder 
conferir, ela também mostra a reacdo do Apple || aos comandos teclados. 

A tela de TV padrdo tem trés modos diferentes de operacdo. Um para caracteres de texto 
em branco e preto e os outros dois s4o dedicados a graficos. No modo texto, a tela é dividida em 
24 linhas com 40 caracteres cada uma. Os modos graficos operam com linhas e pontos e nao mais 
caracteres, e subdividem a tela em elementos menores (os graficos sao discutidos em detalhes 
no Capitulo 7). 

Muitos proprietarios de Apple || usam aparelhos de televisdo para display, ou porque ja 
possufam um ou porque tém uma boa desculpa para comprar. Um monitor de TV produz imagens 
mais precisas do que um TV normal, mas nado pode ser usado como televisor. A Figura 1.2 mostra 
a conexdo com um televisor normal. 

Como se pode ver, o TV nao se conecta direto com o Apple II. Existe um dispositivo de 
conexdo do sistema a antena do televisor. Existe uma chave que estando numa posicao deixa o 
televisor operar de forma comum e em outra faz com que ele sirva de monitor para o Apple II. 
Um cabo vai do aparelho até um circuito colocado dentro do Apple II. O dispositivo em questao 
é chamado modulador de RF e serve para converter o sinal de video gerado pelo Apple |! em algo 





FIGURA 1.2. Conexao a um Televisor Comum. 
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FIGURA 1.3. Conexao a um Monitor de Televisdo. 


que o televisor entende como imagem. Seu vendedor de Apple |! pode |he vender um modulador 
de RF e mostrar-lhe como fazer as conex6es. . 

Um monitor de televisdo ndo requer o modulador de RF; ele se conecta diretamente com o 
Apple |], como é mostrado na Figura 1.3. 


DENTRO DO APPLE II 


O Apple II guarda em si a parte que controla o resto do sistema — sob sua supervisdo, naturalmen- 
te! Logo atras do teclado esta o banco principal de memorias, o microprocessador, os pontos de 
conexao de todos os componentes acessorios, e muito mais. A Figura 1.4 fornece a identificacao 
de todos esses itens. 

A parte interna de seu computador pode ser um pouco diferente do que é mostrado na 
Figura 1.4. O layout bdsico sera o mesmo — a placa maior de circuito impresso com muitos cir- 
cuitos integrados, as pastilhas pretas colocadas em fileiras ordenadas, e ainda algumas pequenas 
placas montadas verticalmente nos espacos disponiveis na parte traseira da placa maior. O numero 
de circuitos integrados e o nimero de placas verticais pode variar de um sistema para outro. 


MEMORIA 


A memoria do computador é medida em unidade chamada byte. Um byte de memoria pode guar- 
dar um caractere ou uma quantidade semelhante de dados. Dependendo do numero de circuitos 
integrados, seu Apple || pode ter de 4096 a 65536 bytes de memoria. Isso 6 normalmente cha- 
mado de 4K a 64K, onde K representa 1024 bytes. A quantidade de memoria indica o que o 
computador pode fazer, como veremos mais tarde. 
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FIGURA 1.4. Dentro do Apple II. 


O Apple I! tem dois tipos de memoria. Uma é a memoria que sO permite ser lida (Read-Only 
Memory ou simplesmente ROM); seu conteUdo nunca muda, mesmo se a tomada for desligada. 
A ROM contém os programas que dao ao Apple || identidade Gnica e permitem que ele responda 
aos Comandos que sao digitados no teclado. O outro tipo de memoria, de escrita e leitura (chamada 
de Randon-Access Memory ou simplesmente RAM) contém dados que podem ser alterados. Os pro- 
gramas em RAM determinam que tarefa especifica seu computador esta executando. 

A memoria de leitura e escrita mantém os dados enquanto a tomada estiver ligada. Quando 
se desliga o Apple II a informacdo contida na RAM é destruida. 


GRAVADOR CASSETTE 
Felizmente pode-se usar um gravador cassette convencional para guardar programas da RAM e 


lé-los depois, de forma que se tenha uma biblioteca de programas em fita cassette. A Figura 1.4 
mostra uma instalacdo com gravador de fita cassette tipica. 


DRIVE DE DISCO 


O drive de disco é muito melhor que o gravador para guardar dados e programas. Ele é mais confia- 
vel, tem maior capacidade de armazenamento e opera mais rapidamente. Além disso, o drive de 
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FIGURA 1.5. Conexao a um Gravador Cassette. 


disco guarda facil e rapidamente dados tais como nomes e enderecos para uma relacdo de mala 
direta ou correspondéncia para um processador de palavra. Os drives de disco existem em varios 
tamanhos e formas; diferentes modelos permitem diferentes capacidades de armazenamento. 
A Figura 1.6 mostra duas unidades do Disk || (produto da Apple Computer Inc.). 


PROGRAMAS 


Deixemos um pouco de lado a apresentacado do equipamento e vamos dar uma olhada nos dife- 
rentes tipos de programas que podem ser usados com o sistema. Nao estamos falando dos dife- 
rentes tipos de coisas que se pode fazer com o Apple ||, mas sobre as diferentes classes de pro- 
gramas que podem coexistir para que o Apple II execute as tarefas. Os programas que fazem 
coisas como jogos, escrever cartas etc., sio chamados programas ap/icativos. Eles sempre sao colo- 
cados em memoria de leitura e escrita (RAM), e ndo em ROM. Vocé os transfere para a RAM a 
partir do gravador ou do disco. Assim, quando vocé quer que seu Apple |! seja um processador de 
palavra, deve usar um disco que tenha o programa aplicativo de processamento de palavra e trans- 
fira o programa para a RAM. O Capitulo 2 explica como fazer isso. 

Muito frequentemente, os programadores escrevem aplicativos numa linguagem de progra- 
macao que lhes é mais facil, porém a linguagem 6 muito avancada para que o Apple || entenda 
sem alguma ajuda. Um programa especial chamado /nterpretador faz exatamente o que 0 nome 
diz. Ele converte o programa aplicativo da linguagem em que ele foi escrito para a linguagem que 
© computador consegue entender. O Apple || tem um conjunto de diferentes interpretadores, que 
podem residir tanto em RAM quanto em ROM. 

O interpretador utiliza, por sua vez, um outro programa que coordena os componentes do 
sistema. Este programa, chamado de sistema operaciona/, executa as funcdes fundamentais de 
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FIGURA 1.6. Ligacao do Disk II. 


operacdo do sistema, como transferir programas de cassette ou disco para a memoria e mostrar na 
tela os dados teclados. O sistema operacional do Apple |! é chamado de Monitor e sempre reside 
em ROM. 


CONTROLADORES DE DISPOSITIVOS EXTERNOS 


Veja as pequenas placas verticais de circuitos impressos colocadas na parte traseira da placa maior 
do Apple II, que sao colocadas nos conectores vazios (slots). Os slots existem para acomodar os 
circuitos especiais. Tais circuitos, chamados contro/adores ou cartées, contém eletrdnica adicional 
para permitir ao Apple |! operar dispositivos periféricos, tais como drives de disco. 

A Apple Computer Inc. produz alguns cartd6es que sao colocados nos slots: alguns deles sao 
colocados em slots especificos, mas a maior parte pode ser colocada em qualquer slot. Na maior 
parte, oS cart6es necessitam de marcas, identificacdes ou outros sinais porque é dificil para os ini- 
ciantes distinguir um do outro. Cada cartao é marcado com seu nome, mas 0 nome nem sempre é 
visivel quando o cartao esta conectado. Vocé pode identificar o cartao pelo lugar onde ele esta 
instalado e pelo que esta conectado nele. Como mostrado na Figura 1.6, o cartao de controle do 
Disk || costumeiramente esta no slot 6; um ou dois drives podem ser conectados a ele. Um segundo 
controlador do Disk II pode ocupar o slot 5 para um terceiro e quarto drive de disco, um terceiro 
controlador pode ocupar o slot 4 para os drives 5 e 6 etc. 

Vamos ver alguns dos outros cartées que vocé pode ter no Apple II. 

Cada um dos trés cart6es mostrados na Figura 1.7 permite operacdo com linguagem de pro- 
gramacao no Apple II. Existem duas versées da linguagem BASIC disponfveis: BASIC integral e 
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FIGURA 1.7. Esquerda para Direita: Cart6es Language System, Applesoft Firmware 
e Integer BASIC. 





FIGURA 1.8. Cartao de Interface Serial. 


Applesoft. Instalando o cartado apropriado no slot 0 pode-se passar de uma linguagem para outra. 
O Language System e o Applesoft Firmware operam em qualquer tipo de Apple II, mas o BAS/C 
integral é especifico para o Apple II Plus. O cartao Language System torna disponiveis outras 
linguagens, como Pascal, da mesma forma. 

O cartao de interface serial (Figura 1.8) usualmente ocupa o slot 1. O dispositivo mais 
comum ligado a ele é a impressora. 


APPLE II 


Nao é freqtiente o uso ao cartdo de interface paralela nostrado na Figura 1.9) ser usado 


juntamente com o de interface série, porque ele invariavelmente tem uma impressora conectada 
nele. Assim, o cartao interface de impressora paralela pode usualmente residir no slot 1. 
A Figura 1.10 mostra 0 cartaéo de interface de comunicacao. Com um modem conectando a 


interface com a linha telefénica, seu Apple |! pode falar com outros computadores em lugares 
remotos. 
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FIGURA 1.10. Cartado Interface de Comunicacao. 
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Existem mais cartdes disponiveis para indmeras aplicacGes de outras fontes que nao a Apple 
Computer Inc. Por exemplo, pode-se conectar cartG6es para controle de luzes e outros dispositivos 
elétricos. Outro cartéo permite que se escrevam programas que sintetizam eletronicamente o som 
de instrumentos musicais. Existe ainda um cartao que funciona como extensor; ele usa um slot do 
Apple II e possui varios slots para cart6es adicionais num chassis separado. 

Alguns sistemas de Apple || tem um cartdo especial instalado para permitir duas vezes mais 
caracteres do que uma linha normal de display. Nesse caso, o monitor de TV (um televisor normal 
nao funciona) é conectado no cartao especial ao invés da conexdo na placa principal. O cartao 
especial se conecta num dos slots da parte traseira da placa principal, normalmente slot 3 ou 4. 
A Figura 1.11 mostra um cartao tipico. 


CONTROLE DE JOGOS 


Vamos concluir nossa tournée pelo interior do Apple || com uma vista sobre os dispositivos de 
controle de jogos que se podem ligar, como mostrado na Figura 1.12. Os controles de jogos sao 
usados com mais freqléncia em programas dedicados a lazer, mas podem ser aplicados, da mesma 
forma, em outras atividades. Estes dispositivos ndo sdo obrigatorios. 


IMPRESSORA 


Vamos observar agora a impressora do sistema (Figura 1.13). 
A impressora se conecta ao sistema tanto pela interface serial quanto pela paralela (depen- 
dendo do tipo de impressora usada), geralmente pelo slot 1. Existem impressoras de todos os tama- 


% VILE SS 2 peep - Soe: Ss 
REFERENCE aa: Ft 


ae 2 eked 


See eee eae ee 


See eed 





Foto: cortesia da Videx. 
FIGURA 1.11. Dispositivo para Formdtacao Especial da Tela. 
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FIGURA 1.13. Conexdo da Impressora. 
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FIGURA 1.14. Conexado da Tabua Grafica. 


nhos, precos e caracteristicas. Algumas tém qualidade de impressdo idéntica a produzida por ma- 
quina de escrever. Outras podem produzir grdaficos (até coloridos); as demais tém caracter/sticas 
de compromisso entre uma e outra. 


TABUA GRAFICA 


A tabua grafica da Apple Computer Inc., mostrada na Figura 1.14, 6 um dispositivo portatil que 
explora a capacidade grafica do Apple || de forma especial. Com sua caneta, pode criar figuras, 
desenhos, mapas, graficos e outros desenhos livres diretamente na tela, em cores. Sob sua dire¢do, 
ele desenha linhas retas, formatos sdlidos e pontos. Seu desenho pode ocupar a tela inteira ou ape- 
nas parte dela. Pode-se mover o desenho ao largo da tela, aumenta-lo, reduzi-lo e separar suas cores 
uma a uma. Em qualquer momento durante esse processo, pode-se guardar o desenho obtido em 
disco para chaméa-lo depois. Pode-se ainda medir distancias com este dispositivo. 


2 


Como o Apple II Opera 


Qualquer sistema de computador intimida um pouco quando nos sentamos a sua frente, mesmo 
que esteja inteiramente instalado, como o seu Apple II deve estar antes de prosseguirmos. Este 
capitulo vai tornar mais confortadvel seu relacionamento com o Apple II, explicando como usé-lo, 
mas nao como monta-lo. Os manuais de usuario que vém com cada um dos equipamentos de 
fabrica trazem informacdo completa para ajudd-lo na instalacdo. Se for necessdria mais assisténcia 
para certificar-se que tudo esta correto, verifique com outra pessoa que também tenha um Apple || 
como oO seu, Ou Com oO distribuidor que lhe forneceu o equipamento. 


LIGANDO NA TOMADA 


Verifique que todos os componentes do sistema estejam ligados juntos, corretamente, e ligue o 
televisor. Deixe o volume no minimo. Coloque a chave do dispositivo conectado a antena de TV 
na posi¢ao GAME ou COMPUTER. Sintonize o canal especificado nas instrucdes que acompanham 
oO modulador de RF (normalmente canal 33). Se vocé nao sabe qual canal usar, pergunte a alguém 
que tenha um sistema igual ou contate o seu fornecedor. 

Procure a chave liga-desliga atras do Apple II, perto de onde sai o cabo de forca. Ligue a 
chave. Vocé devera ouvir um sinal vindo de dentro do equipamento. O sinal indica que o compu- 
tador esta pronto. A lampada POWER do teclado devera acender, a menos que esteja queimada. 

Se o sinal nao for ouvido, desligue a chave e ligue novamente. Se nada for ouvido, desligue 
0 computador. A lampada acendeu? Se nado, desligue o Apple I! e ligue uma lampada ou radio para 
ver se ha forga na tomada. Leia as instru¢des novamente e confira as conexGes para certificar-se de 
que tudo esta ligado corretamente. Se ainda assim o computador ndo emitir o sinal, DESLIGUE-O! 
Desconecte da tomada e peca auxilio a alguém que tenha mais experiéncia (seu distribuidor, por 
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exemplo). Vocé podera causar muitos danos tentando mexer no computador ou desligando cone- 
x6es de fios. 


O QUE VOCE VE NO TELEVISOR 


Uma vez ligado, e depois de soar o sinal indicando que tudo esta correto, aparecera uma imagem 
na tela do seu televisor. 

O contetido da imagem depende do tipo de Apple I! que estiver sendo ligado, mas uma Coisa 
é bem distinguivel, por ficar piscando em intervalos regulares de tempo; este retangulo branco 
piscante 6 o chamado cursor. Ele marca a posicdo onde o proximo caractere digitado no teclado 
aparecera na tela. A proxima secdo explica o que fazer se o Cursor nao aparecer. 


Se Vocé nao Vir o Cursor 


Seu Apple I! pode ter o cartéo Language System instalado com um ou mais drives do Disk II. 
Neste caso nao se vé o cursor. Em seu lugar ouve-se barulho de estalos e chiados vindos do drive 
do Disk II, e a lampada vermelha IN USE na caixa do drive estara acesa. Por ora, quando isso 
acontecer acione a tecla RESET. O cursor aparecera e o drive de disco ficara em siléncio. Va para 
a proxima secdao. 

Alguns sistemas como o Apple I! séo configurados para permitir mais de 40 caracteres em 
cada linha. Para ver o cursor nestes casos deve-se digitar uma seqléncia de comandos especiais 
como segue: 


1. Acione a tecla CTRL e mantenha-a abaixada, acione a tecla B e em seguida solte ambas. 


2. Para o proximo comando, vocé deve saber em qual slot o cartao especial (aquele ao qual o 
monitor de TV esta ligado) esta conectado, provavelmente slots 3 ou 4. Pode-se abrir o 
Apple II e olhar dentro — os slots sio numerados de O a 7 da esquerda para a direita. A 
Figura 1.11 explica o que procurar. Peca ajuda a alguém (seu fornecedor) se estiver em 
duvida. 


3. Se o seu monitor esta conectado no cartdo do slot 3, digite PR#3 e acione a tecla 
RETURN. Se esta no slot 4, use PR#4; para slot 2 digite PR#2 etc. 


4. O cursor agora fica visivel, embora ele possa nao piscar (o que esta correto). Continue 
como descrito abaixo. 


TABELA 2.1. Caracteres de Entrada. 


* Monitor 
Integer BASIC 
Applesoft 
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O CARACTERE DE ENTRADA 


A esquerda do cursor existe um outro caractere. Ele é o primeiro da linha. Pode ser um asterisco 
(*), um sinal de maior (>) ou um fecha-colchetes (]). O Apple I! é um computador de multi- 
linguagens e o caractere de entrada indica qual a linguagem que esta esperando instru¢do no mo- 
mento. A Tabela 2.1 mostra os trés caracteres de entrada e suas linguagens correspondentes. 


*6 o Monitor 


Em muitas versdes do Apple I! 0 primeiro caractere que se vé ao se ligar o aparelho é 0 *. Se este 
nao for o seu caso pule esta secdo e a seguinte. 

O asterisco 6 a entrada para o Monitor de Linguagem Assembler do Apple ||. Em geral, 
apenas Os usuarios mais avancados tém a necessidade de se comunicar diretamente com o Monitor. 
Se vocé deseja experimentar, pode fazé-lo. Embora nao haja condicdo de fazer nada por ora com o 
Monitor, vocé devera desligar e religar a chave para anular a entrada do Monitor e cancelar os 
efeitos da experiéncia. 

Quando o * aparece, deve-se dizer ao Apple |! que pule para o BASIC. 


CTRL-B em BASIC 


Existe um comando no Monitor que instrui ao Apple !! para pular para o BASIC. Para permitir 
este comando, acione e deixe acionada atecla CTRL, enquanto aciona e solta atecla B. Solte entado 
a tecla CTRL e acione RETURN. Um caractere de entrada diferente aparecera entao sobrepujando 
o *. Dependendo do tipo de Apple || usado e de suas opcdes, aparece o caractere > ou J]. 

A palavra BASIC vem de Beginner’s All-purpose Symbolic Instruction Code, uma linguagem 
de computa¢ao muito usada, desenvolvida pelo Instituto Dartmouth. O Apple II suporta duas 
versoes de BASIC: 0 Integer BASIC e o Applesoft. Ambas as versGes contém caracteristicas do 
BASIC original de Dartmouth. 


> @0 Integer BASIC 


O caractere > indica que o Apple II esté pronto para receber instrucdes em Integer BASIC. As 
regras do Integer BASIC sdo diferentes daquelas do Applesoft, mas as duas tem muita coisa em 
comum. Por ora concentremo-nos nas instrucGes que s4o comuns as duas versdes, de forma que 
nao precisa haver preocupacdes com o tipo de BASIC usado. 


] € o Applesoft 


O caractere | informa que o Apple I! esta pronto para receber instrucdes do Applesoft. Nao se 
preocupe por ora com o tipo de BASIC que esta usando. Quando isso se tornar importante, abor- 
daremos as diferencas entre ambos. 
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O TECLADO 


O teclado do Apple II (veja Figura 2.1) se parece em muito com o teclado de uma maquina de 
escrever Comum, mas ele tem cinco teclas que nado existem nessas maquinas. Duas estado a esquerda, 
com as inscricOes misteriosas ESC e CTRL. As outras trés estado a direita, com RESET, <e-. Exis- 
tem mais duas teclas do lado direito desconhecidas: RETURN e REPT. 

Va em frente e digite no teclado. Tudo que for colocado no computador pode ser cancelado 
ligando e desligando a chave. 

Durante a digitacao, pode-se perceber que todas as letras digitadas sao maitisculas, como se 
vé na tela, a menos que se acione a tecla SHIFT antes de se teclar uma letra. O Apple || standard 
sO sabe mostrar na tela as letras maitsculas. Pode-se conectar um dispositivo que permite o uso 
de maiusculas e mindsculas. Além disso, existem programas que sabem como mostrar na tela tanto 
maidsculas quanto mindsculas. 


A Tecla RESET 


RESET € uma tecla muito especial no teclado do Apple Il. Quando o RESET é acionado, para 
tudo. Nao importa o que o computador esteja fazendo no momento que se aciona o RESET, o 
controle do Apple II retorna ao teclado. Dependendo do Apple ||, o RESET faz voltar ao Monitor, 
Integer BASIC ou Applesoft com o aparecimento do caractere de apresentacao respectivo. 

As vezes o RESET causa um bocado de problemas, especialmente se o Disk || esta sendo 
usado no momento em que se aciona a tecla. Assim, deve-se prestar muita atencao para nao acionar 
a tecla RESET acidentalmente. Tome cuidado especial ao acionar a tecla RETURN, pois o dedo 
pode facilmente subir um pouco mais acionando o RESET sem querer. Algumas versdes do Apple 
11 dao uma protecdao especial contra esta acao, exigindo o acionamento da tecla CTRL-RESET ao 
invés de simplesmente RESET (veja a discussdo sobre a tecla CTRL a seguir). 





FIGURA 2.1. O Teclado do Apple Il. 
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A Tecla RETURN 


A medida que se digita, os caracteres so mostrados na tela. Além disso, o Apple I! guarda tudo 
na memoria sem tentar interpretar o que foi teclado até que se acione a tecla RETURN. Esta tecla 
informa ao computador que a linha de comando que estava sendo digitada ja terminou. Quando se 
aciona RETURN, o Apple I! limpa qualquer caractere estranho a direita do cursor. Entdo faz a 
anéalise do comando digitado. Se a seqiiéncia de caractere representar um comando que ele pode 
executar, ele executa a acdo apropriadamente. Por outro lado, se for ouvido o sinal sonoro e apa- 
recer uma das mensagens abaixo (ou eventualmente outra mensagem do mesmo tipo): 


PSYNTAX ERROR 
HHH SYNTAX ERR 


O Apple Il esté dizendo que néo entendeu o comando dado antes da digitacao da tecla 
RETURN. Vocé deve redigitar a linha (sem o erro detectado pelo Apple I!). 


A Tecla SHIFT 


As letras sido sempre maitsculas no Apple I! standard. Assim, a tecla SHIFT nao muda as letras de 
minusculas para maidsculas. Ela faz com que uma mesma tecla permita dois caracteres diferentes. 
Um deles é obtido pelo acionamento apenas da tecla, sem a tecla SHIFT. O caractere que se obtém 
pelo acionamento da tecla em conjunto com SHIFT é mostrado na parte de cima da tecla. 

Usa-se a notacdo SHIFT- para descrever o duplo acionamento envolvendo a tecla SHIFT. 
Por exemplo, SHIFT-3 produz o caractere #. 

Algumas teclas de letras nado imprimem letras quando se usa a tecla SHIFT. A tecla N, por 
exemplo, imprime A, e um @ é apresentado quando se aciona SHIFT-P. A tecla G tem a palavra 
BELL escrita no alto, o SHIFT-G imprime a letra G, e nado fornece o sinal sonoro. 


A Tecla CTRL 


CTRL é a contracdo de control. A tecla CTRL sempre é usada junto com outra tecla da mesma 
forma que o SHIFT. Deixa-se a tecla CTRL acionada enquanto se aperta e solta a outra tecla. Este 
livro se refere ao acionamento da tecla CTRL com outra tecla pela especificacdo CTRL-. Por 
exemplo, CTRL-B significa que as teclas CTRL e B devem ser acionadas em conjunto. 

A tecla CTRL, como o SHIFT, permite a algumas teclas que tenham funcoes especiais. A 
tecla G é a Unica que tem informada no alto a sua funcdo obtida com a tecla CTRL: BELL. A 
fun¢ao do BELL fica 6bvia quando se aciona CTRL-G e 0 Apple I! responde com o bip. Ativou-se 
o sinal sonoro do computador. 

Existem outras combinacdes de CTRL que causam varias reacdes ao Apple II. Ainda ha 
pouco mencionamos o comando CTRL-B no Monitor que faz a passagem para o BASIC. 

Outra combinacao intercssante 6 o CTRL-X. Ela informa ao Apple I! que deve esquecer 
tudo o que foi digitado na linha de comando presente para que se recomece. Tente digitar qualquer 
coisa e em seguida acionar o CTRL-X. O cursor volta para o inicio da linha. Os caracteres antigos 
ainda permanecem na tela mas nado tém mais significado para o computador. Ele entende como se 
eles nunca tivessem sido digitados. 
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A Tecla Esc 


ESC vem de escape, que € um termo usado desde quando as te/etypes eram os terminais mais 
usados. Embora o nome sugira, acionar a tecla ESC nao provoca interrupcdes. A tecla ESC tem 
muitos usos, alguns dos quais aparecem neste capitulo e o resumo aparece no proximo. 

Diferentemente de SHIFT e CTRL, a tecla ESC nunca é usada em conjunto com outra tecla. 
Ela @ acionada e solta em separado, antes que outra seja acionada. Esta operacao da tecla ESC 
com outra é chamada sequéncia de escape. 

Uma seqténcia simples de escape é ESC-@. Aciona-se esta sequiéncia de escape, primeiro 
acionando a tecla ESC, a seguir acionando e mantendo acionada a tecla SHIFT, enquanto se 
aciona a tecla P (SHIFT-P = @). O resultado? Tudo o que esta na tela é zerado, e o cursor se move 
para o canto esquerdo no alto da tela. (Em “‘computés’’ o canto esquerdo no alto da tela é cha- 
mado de home.) 


As Teclas < e > 


As duas teclas de flechas sao chamadas de flecha-a-esquerda e flecha-a-direita. 

As teclas « e > sdo muito Uteis porque com elas pode-se corrigir erros de digitacdo que 
eventualmente tenham sido cometidos, bem como alterar dados que tenham sido colocados. 
A tecla <, como a tecla backspace em maquinas de escrever, cada vez que é acionada, o carac- 
tere sob o cursor é apagado da memoria do Apple || e o cursor volta uma posicao para a esquerda. 
Tente agora. Digite uma palavra (tente PRINT). Acione « varias vezes e veja como o cursor volta 
percorrendo a palavra digitada de tras para diante. Veja que os caracteres nao sao apagados da 
tela. Pode ter certeza que eles ja foram esquecidos pelo Apple II. Tente voltar o cursor todo a 
esquerda da tela. Quando se chega ao limite e se aciona < de novo, o cursor volta uma linha e 
O novo Caractere de entrada aparece. 

Como vocé deve estar suspeitando, a tecla > move o cursor para a direita ao longo da 
linha digitada. A medida que ele vai para a direita, todo o caractere pelo qual o cursor passa é 
copiado pela memoria do Apple || exatamente como seria se ele fosse recém-digitado. Para ver a 
tecla em acao, digite uma nova palavra e volte o cursor alguns caracteres usando <-. Agora acione 
+ algumas poucas vezes. Cada vez que essa tecla é acionada, o caractere pelo qual o cursor passa 
é levado de volta para a memoria do Apple I!, como se ele estivesse sendo redigitado. 


A Tecla REPT 


REPT é abreviacdo de repeticao. Se a tecla REPT fica acionada e outra tecla é tocada ao mesmo 
tempo, esta outra tecla sera repetida até que ambas se soltem. Isso é bastante Util quando a outra 
tecla é de flecha e é necessdrio limpar (<) ou recopiar (—) muitos caracteres. 

Para que a funcdo de repeticao funcione corretamente, deve-se primeiro acionar a tecla Cuja 
funcdo se deseja repetir, acionando-se entao a REPT. Soltando a REPT a repeticdo cessa. 


As Outras Teclas 


As outras teclas do Apple II, sem divida sao familiares. Sao elas as letras do alfabeto, os numeros 
de zero a nove, e um Conjunto de simbolos padronizados. 
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Muitos datilégrafos nado distinguem entre o numero zero e a letra O ou entre a letra/ eo. 
numero um. O Apple II ndo pode aceitar esta ambigiidade. Deve-se tomar bastante cuidado para 
que se digite um numeral quando se pede um numeral. Para ajuda-lo a lembrar, o teclado do 
Apple || mostra o zero com uma barra cruzada, e os zeros mostrados na tela também tém esta 
barra. 


O GRAVADOR CASSETTE 


Se o seu sistema possui um gravador cassette, ele pode receber programas através de fitas cassette. 
Algumas delas vem com o Apple ||; pode-se comprar outras; e pode-se também montar um arquivo 
com fitas proprias. (Veja explicacdes no Capitulo 4.) 


Manuseando Cassettes 


Deve-se ter cuidado com o manuseio das fitas cassettes. Elas se danificam muito facilmente. Nao 
importa o quanto sua pele seja limpa; o dleo natural estraga a fita. Certifique-se de que colocou as 
fitas em suas Caixas corretas apos usa-las. Nao as guarde em lugares quentes, sob a luz direta do sol. 
ou sob campos magnéticos (tais como os encontrados perto de motores elétricos). 


Rotule Todos os Cassettes 


Deve-se rotular os cassettes com informacdo sobre os programas que eles contém. Isso evita o 
aborrecimento de pesquisar todo um arquivo de cassettes, um a um, para se obter um programa 
desejado. 


Protegendo os Cassettes Contra Escrita 


Cada cassette tem dois entalhes na parte traseira. Os gravadores geralmente tém um dispositivo que 
sente a presenca destes entalhes e ndo permitem nova gravacdo se eles nao estao presentes. As fitas 
novas tém um pedaco de plastico cobrindo o entalhe, de forma que se pode gravar e ler a vontade. 
Os programas importantes gravados nos cassettes podem ser protegidos removendo a cobertura 
de plastico. 

Para determinar qual dos dois entalhes é 0 correto, segure o cassette de forma que a parte 
exposta da fita fique exposta para a frente e o lado que se deseja proteger seja o de cima. Remova a 
parte plastica do lado direito para evitar gravacdes sobre a superficie superior (veja a Figura 2.2.). 
Cobrindo o entalhe com fita adesiva pode-se gravar dados numa fita que foi protegida. 


Ajustando o Volume de Leitura 


Deve-se determinar o volume de leitura do gravador cassette no nivel proprio para o Apple II. Se o 
volume for muito alto ou baixo, a informacdo da fita sera distorcida e o computador nao sera 
capaz de entendé-la. 
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Liberam a gravacao 





FIGURA 2.2. Dispositivos de Protecao em Fitas Cassette. 


A unica forma de determinar o nivel de volume correto para seu gravador é 0 método de ten- 
tativa e erro. Aqui esta um procedimento geral. Primeiro, tente carregar um programa com o volu- 
me bem baixo. Se nado funcionar, aumente um pouco e tente de novo. Permaneca ajustando para 
cima até que o programa seja carregado satisfatoriamente. 

Pode-se usar uma das fitas que vem com o Apple II. Se o caractere de entrada apds o cursor 
for |, ache o cassette chamado “Color Demosoft’’. Se o caractere de entrada for >, ache o cassette 
chamado “Color Graphics”. 

Coloque a fita no gravador. Certifique-se de que o nome do programa estd em cima. Para 
cada posicdo do controle de volume: 


1. Rebobine a fita completamente. 

2. No teclado do Apple II, digite a palavra LOAD. 

3. Aperte o botao PLAY do gravador para iniciar a leitura. 
4. Acione a tecla RETURN. 


Apos acionar RETURN, o cursor desaparece. Depois de 15 ou 20 segundos, pode-se analisar 
0 ocorrido. 

Se apareceu a mensagem ?SYNTAX ERROR ou ***SYNTAX ERROR, néo ajuste o volume, 
volte ao passo 1 e tente novamente. Se acontecer de novo, tente limpar a cabeca de leitura ou usar 
uma fita ou gravador diferente. 

Se nada acontece, ou se é mostrado ERR ou ERRERR, acione RESET, coloque o volume um 
pouco mais alto, e tente novamente. 

Se for ouvido o bip, ou nenhuma mensagem aparecer, as coisas vao indo bem. O Apple II 
achou o inicio do programa da fita e esta carregando. Depois de mais uns 15 segundos (dependen- 
do do tamanho do programa da fita), vai ser ouvido outro Dip e o caractere de entrada, bem como 
O cursor, reaparecerao na tela. Deve-se entao desligar o gravador. Anote o volume utilizado para 


20 APPLE II 


que nado seja necessdario repetir este processo novamente quando estiver usando o gravador longe 
do Apple II. 

Quando for visto o caractere de entrada do BASIC e o cursor, 0 programa foi carregado com 
sucesso. 


USANDO O DISK Il 


Se o sistema possui um ou mais drives do Disk |! conectado ao Apple II, pode-se operar programas 
de disquettes ao invés de cassettes. O ‘‘System Master Diskette’’ fornecido junto com o Apple |! 
tem a maioria dos programas que a Apple Computer Inc. fornece com os cassettes, mais alguns 
programas extras especialmente projetados para o Disk II. 


Manuseando Diskettes 


Deve-se ter extremo cuidado no manuseio de disquette. Eles sao muito mais delicados do que os 
cassettes. Nunca dobre um disquette. Nunca toque a superficie do disquette (a parte que aparece 
sob a abertura oval), e nunca force a entrada de um disquette no drive do Disk II. Sempre reco- 
loque o disquette em sua capa protetora quando ele estiver fora do drive, e proteja-o contra o 
calor, a luz direta do sol e campos magnéticos (como os encontrados perto de motores elétricos). 
Tenha especial cuidado com o “System Master Diskette’. 


Como Colocar os Disquettes Dentro do Drive do Disk II 


A forma apropriada de inserir o disquette no drive do Disk II é mostrada na Figura 2.3. Segure o 
disquette entre os dedos polegar e indicador de forma que o polegar cubra a etiqueta. Abra a porta 
do drive do Disk Il e suavemente coloque o disquette totalmente dentro do drive. Nao deve haver 
resisténcia. Uma vez que o disquette esteja dentro do drive, feche a porta gentilmente. Ela deve 
fechar-se facilmente. Se houver alguma resisténcia, solte a porta e empurre o disquette inteira- 
mente para dentro do drive, tentando novamente. Se a porta for forgada, destruira o disquette. 
As vezes ajuda esperar que o disquette seja centrado, esperando que o drive comece a girar e entao 
fechando a porta. 


O SISTEMA OPERACIONAL EM DISCO 


Antes que se possa usar qualquer programa do drive de disco, deve ser colocado na memoria um 
programa especial chamado Disk Operating System. Este programa, também chamado DOS con- 
trola as atividades realizadas pelo drive de disco. O processo de colocar uma copia do DOS na 
memoria é chamado de booting. Em “computés”’ diz-se fazer o “‘boot do disco” ou ‘‘boot do 
DOS” ou simplesmente “boot DOS”. 

Deve-se executar o boot do DOS a cada vez que se desliga o equipamento e se liga novamente. 
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Inserindo o Disquette no Disk II. 


FIGURA 2.3. 





Drive de Disco Standard para o Boot do DOS. 


FIGURA 2.4. 
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Fazendo Boot do DOS 


Existem varias formas diferentes para fazer o boot do DOS, dependendo da configuracao do sis- 
tema e da linguagem utilizada para iniciar o boot. Cada método assume que o drive de disco esta 
conectado no slot 6 e o drive 1 esta ligado no cartdo de controle. Isso é mostrado na Figura 2.4. 

Coloque o “System Master Diskette’’ no drive correto e feche a porta do mesmo. Em alguns 
casos, quando o Language System esta presente, deve-se usar um disquette especial, o “Integer and 
Applesoft II’ antes do disco do DOS. Esta situacao é descrita abaixo na secdo sobre boot com o 
Language System. 

Apos um boot bem-sucedido usando um dos métodos acima descritos, a tela deve parecer 
com um dos padrées mostrados na Figura 2.5. 


Boot Autostart 


A forma mais facil de fazer o boot é pelo boot autostart. Como o nome indica, o boot é automa- 
tico. Para tornar o Boot Autostart passivel, seu equipamento deve ter o Autostart Monitor. Se, 
quando se ligar o Apple I, o drive do Disk || ranger e estalar, e a lampada vermelha IN USE da 
parte frontal do drive ficar ligada, o sistema possui o Autostart Monitor. 

Quando ele esta presente sem o Language System, o boot do DOS é um procedimento de um 
sO passo. Com o Apple II desligado, coloque o ‘System Master Diskette’ no drive do Disk II 
apropriado e feche a porta. Ligue o aparelho. Apds alguns segundos, o disco para e a tela passa a 
mostrar um quadro semelhante a um dos mostrados na Figura 2.5. 


Boot a Partir do Monitor 
Quando o caractere de entrada * aparece na tela, o Monitor de Linguagem Assembler esta aces- 
sado e esperando comandos. Existem algumas formas de fazer o boot do disco a partir do Monitor. 


Salto do Monitor para o Boot 


Pode-se fazer 0 boot do DOS do drive 1 no slot 6 (veja Figura 2.4) com o seguinte comando dado 
no Monitor: 


#xC&00G 


Lembre-se de acionar a tecla RETURN. A lampada vermelha IN USE do Disk I! acenderé, e em 
alguns segundos a tela se parecera com o visto na Figura 2.5. 


Boot do Monitor com o CTRL-P 


O outro comando do Monitor para gerar o boot do DOS é através do CTRL-P. Para fazer o boot a 
partir do Monitor usando este comando, digite o numero do slot do drive que se deseja ler no disco 
(usualmente 6), acionando CTRL-P (nada aparecerdé na tela). Agora acione RETURN. Apos alguns 
segundos a tela se parecera com aigo da Figura 2.5. 
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FIGURA 2.5. Boot Satisfatério do System Master Diskette. 
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Boot a Partir do Integer BASIC ou Applesoft 


O mesmo comando de boot é reconhecido por ambas as versdes de BASIC, Integer e Applesoft. 

Apos a entrada do BASIC (> em Integer BASIC ou | em Applesoft) digite as letras IN ou 
PR, o sinal de #, e o numero do slot de onde se fard o boot (usualmente 6). O comando se parece 
com: 


IN#R6 
PR HS 


Agora acione a tecla RETURN. Apos alguns segundos a tela se parecera com o mostrado na Figura 
2:6. 


Boot a Partir do Language System 


Sob tais condi¢gdes, fazer 0 boot do DOS com a presenca do System Language é um procedimento 
com dois passos. A verséo do DOS a ser usada determina o procedimento. O numero de versdo do 
DOS no “System Master Diskette’’ esta estampado no proprio disquette. E um numero como 3.3, 
3.2.4 OU-d2. 

Entrando com a versdo 3.3 do DOS, nao importa se existe ou ndo o Language System. Use 
o “‘System Master Diskette’’ com um dos procedimentos descritos acima. O DOS é carregado do 
disquette para a memoria. Outro passo é executado automaticamente e faz com que tanto o 
Integer BASIC quanto o Applesoft fique disponivel imediatamente, via Language System. Quando 
o Disk II cessa, 0 boot esta terminado e a tela fica semelhante a uma daquelas mostradas na Fi- 
gura 2.5. 

Carregar as versdes 3.2.1, 3.2 e menores do DOS requer dois disquettes. Primeiro é preciso 
colocar o disquette chamado ‘Integer and Applesoft II’ no Disk I! correto, normalmente aquele 
conectado no slot 6, e drive 1. Entéo executa-se uma das funcdes para boot descritas acima. O 
drive emite alguns sons e a l4mpada vermelha IN USE na frente da caixa do drive acende. Em 
POUCOS segundos, aparece a seguinte mensagem na tela: 


INSERT BASIC DISK AND PRESS KETUERN 


Abra agora o drive e remova o disquette. Insira o ‘System Master Diskette’ no drive e feche 
a porta. Acione a tecla RETURN do teclado. Apds mais alguns segundos, a tela se parecera com 
uma das telas da Figura 2.5. Isso indica que o boot foi executado corretamente. 


Como Ver o Catdlogo de Disquettes 


Se o boot foi executado corretamente, pode-se ver que programas o disquette contém. No teclado 
do Apple I! digite: 


CATAL GG 


A tela mostrarad algo como o que esta abaixo. (Vocé se lembrou de acionar a tecla RETURN?) 
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NISk VOLUME 254 


#T OOf HELLO 

#7 O83 APFLE-TREK 
#7 O18 ANIMALS 

#h OO9 UPDATE 3.2.1 
#I O14 CORY 

#7 OOF COLOR DEMO 
#] OSS BRICK OUT 

#7 OF4 SPACE WAR 

#1 O50 THE INFINITE NO. OF MONEEYS 
#7 O8) COLOR SKETCH 
#[ O83 SUPERMATH 

#I OFG APPLEVISICN 
#[ O17 BTORHYTHM 

#7] O27 PINBALL 


Como Fazer o Boot de Outros Disquettes 


Descrevemos como realizar 0 boot do DOS a partir do “‘System Master Diskette’. O procedi- 
mento é exatamente o mesmo para qualquer disquette onde foi colocado o Disk I. Os disquettes 
inicializados para outros computadores ou outro tipo de drives normalmente nado funcionam no 
drive do Disk II. 


PREPARANDO NOVOS DISQUETTES 


De tempos em tempos precisa-se de novos disquettes para os programas que se rodam no Apple II. 
Antes de se usar um disquette com o Disk I! pela primeira vez, deve-se inicializa-lo. Se o programa 
especifico que se esta usando inclui rotina especial para inicializar disquettes, use-a preferencial- 
mente. Na sua auséncia, pode-se usar o método geral a seguir para preparar disquettes extra. 

O processo de inicializacdo torna o disquette pronto para uso subseqiente. Durante a iniciali- 
zacao, seja qual for o programa BASIC que esta sendo usado, ele é salvo na memoria, e se torna o 
programa de apresentacao do disquette. O programa de apresentacdo é automaticamente carregado 
e rodado toda vez que se faz o boot do disquette. Se existe um programa de apresentacdo em sua 
mente, OK. Se nado, pode usar a Figura 2.6 como modelo. Use o programa exatamente como é 


REM INICIALIZADO EM data 
REM MEMORIA DO SISTEMA bytes 


REM VERSAO DO DOS ntmero 
PRINT “‘nome do disco” 
END 





FIGURA 2.6. Modelo de Apresentacao de um Programa. 
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mostrado exceto para os termos em letras mintsculas, que devem ser substitufdos pelas infor- 
macdes de momento. Em data, coloque a data na qual o disquette esta sendo inicializado. Em 
bytes, coloque o nimero de bytes da memoria do sistema (32K, 36K etc.). O nimero é o nimero 
da versao do DOS que estd presente no disquette mais recente (algo como 3.2, 3.2.1 ou 3.3). 
O nome do disquette 6 o nome que se deseja dar para aquele disquette especial. Abaixo vai uma 
ilustragao de um programa de inicializacao: 


NEW 


TO REM INICTALIZADO EM 1/71/81 
eQ REM MEMORTA DO SISTEMA 45K 
20 REM YVERSAO DO DOS 3.2.4 

40] PRINT “MISC.,VOL.3% 

wo) END 


Assim, para inicializar um disquette, primeiro prepare o programa de apresentacdo, ponha o 
disquette no drive, se digite o sequinte comando: 


INIT HELLO 


Certique-se que a porta do drive esteja fechada e acione RETURN. A laémpada vermelha do 
drive acendera, acompanhada dos estalos e ruidos caracteristicos. O processo inteiro de iniciali- 
zacgao leva aproximadamente dois minutos, de forma que deve haver paciéncia. Quando a lampada 
apaga, O processo estara completado. 

Agora prepare uma etiqueta para o disquette. Remova-o do drive e aplique a etiqueta. 


CARREGANDO E RODANDO UM PROGRAMA 


Existem muitos programas ja escritos para o Apple II. Alguns vém em cassettes, outros em dis- 
quettes, ou em ambos. Alguns deles sao escritos em Integer BASIC e outros em Applesoft. De 
forma geral, um programa escrito para o Integer BASIC nao funciona no Applesoft e vice-versa. 


USANDO A VERSAO CORRETA DO BASIC 


Embora muitas versdes do Apple I! venham com as duas versdes da linguagem, nem todas tem essa 
possibilidade. O Apple I! Plus nado tem o Integer BASIC a menos que o cartaéo Language System ou 
oO cartéo Integer BASIC estejam presentes. Por outro lado, o Applesoft nao é encontrado em 
muitas versOes do Apple I! a menos que se leia um interpretador de cassette ou disco. 

Em um Apple II standard é facil obter a entrada no Integer BASIC (>). Acione a tecla 
RESET e a seguir o CTRL-B (lembrando-se de terminar com RETURN). 

E dificil de se obter o caractere de entrada do Applesoft em um Apple I! standard, desde 
que ele reside num disco ou fita. Deve-se instruir 0 computador para carregar o interpretador do 
Applesoft na memoria a partir do disco ou da fita. 
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Antes de se usar o drive de disco deve-se fazer o boot do DOS como descrito anteriormente 
neste capitulo. Uma vez que o DOS esta carregado, pode-se carregar o interpretador Applesoft 
colocando-se o System Master Diskette no Disk II e digitando o seguinte comando: 


EP 


O drive rangera e estalaré por alguns segundos e entdo o caractere de entrada do Applesoft ( ]) 
aparecera na tela. 

Pode-se também obter o interpretador do Applesoft a partir de fita cassette. Use o cassette 
chamado ‘’Applesoft II’ (da Apple Computer Inc.), coloque-o no gravador e rebobine-o todo. 
Digite o comando: 


LOat 


Antes de acionar o RETURN, acione a tecla PLAY para inciar o movimento do gravador. 
Logo se ouvira o bip do Apple II, o que indica que foi iniciado o carregamento do interpretador 
Applesoft. O tempo gasto vai de um minuto e meio a dois minutos. Uma vez carregado o pro- 
grama, sera dado um segundo bip. Desligue o gravador cassette. O caractere de entrada do Apple- 
soft estara presente na tela. 

A partir do Applesoft, pode-se passar para o Integer BASIC digitando o comando: 


TNT 
Desejando voltar para o Applesoft, deve-se recarregar o interpretador Applesoft do disco ou 
do cassette. 


CARREGANDO UM PROGRAMA DO CASSETTE 


Com a versdo apropriada do BASIC carregada (ou o Apple I! apto a fazer a selecao automatica- 
mente), estes so os passos para carregar um programa a partir do cassette: 


1. Posicione a fita no inicio do programa. Este sera normalmente no inicio da fita, e nesse 
caso deve-se rebobinar a fita completamente. Se o programa desejado nao esta no inicio 
da fita, deve-se carregar todos os programas precedentes, em ordem, para posicionar a 
fita no lugar correto. 


2. No teclado do Apple I! digite o comando, 
Load 
3. Aperte o botao PLAY no gravador cassette para iniciar. 


4. Acione a tecla RETURN. 


Apés acionar RETURN, o cursor desaparece. Apos alguns segundos, o Apple I! gera o bip 
para indicar que iniciou a carga do programa. Mais tarde um outro bip indica que o processo ja 
terminou. Acione entao o botao STOP do gravador cassette para para-lo. 

O programa estaé carregado. Se nenhum bip for ouvido ou aparecer alguma mensagem de 
erro durante o processo de leitura, reveja o ajuste de volume de acordo com as recomendacées 
dadas anteriormente, neste capitulo. Se o teclado nao responder a tecla RESET deve ser acionada, 
ou deve-se desligar e ligar o computador. Se for necessdrio, recarregue o interpretador a partir 
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do cassette ou disquette. Se ainda aparecerem problemas, sua fita cassette provavelmente esta 
inutilizada e deve ser trocada. 


CARREGANDO UM PROGRAMA DO DISCO 


Uma vez que foi feito o boot do DOS, pode-se ler programas a partir do disco, com o comando: 


LmAlt nome do programa 


Nome do programa se refere ao programa que deve ser carregado. Naturalmente, o programa indi- 
cado deve estar presente no disco que vai ser colocado no drive. 


INICIANDO A EXECUCAO DE UM PROGRAMA 


Quando o programa desejado esta carregado na memoria, use 0 comando seguinte para iniciar sua 
execucao: 


RAIN 


O programa sai do controle do Apple II, incluindo teclado e video. Para recuperar o con- 
trole, pode-se digitar CTRL-C, em muitos programas. Pode ser que seja necessario acionar a tecla 
RETURN. Se isso nao funcionar, leia as instrucdes de operacdo do programa que esta rodando. 
Numa emergéncia pode-se acionar a tecla RESET ou desligar o Apple II, porém em ambos os casos 
O programa pode ser perdido. 


CONECTANDO TV COLORIDA 


O Apple Il suporta graficos em cores. Se o programa que esta sendo usado ou escrito usar esta 
caracteristica, deve ser feito o ajuste das cores do televisor ou do monitor de TV para um balanco 
correto. A Apple Computer Inc. fornece um programa para auxiliar nessa tarefa. Dentro do pro- 
grama Integer BASIC (>) use 0 cassette ‘Color Graphics”. Com o Applesoft, (|) use o cassette 
“Color Demosoft’’ ou o programa COLOR DEMOSOFT em disquette. Em ambos os casos, Car- 
regue e rode o programa de acordo com as instrucdes precedentes neste capitulo. 

A tela se parecera com uma das mostradas na Figura 2.7. 

O que se vé na Figura 2.7 6 chamado menu. Um menu permite varias escolhas (quatro, no 
caso) e pede para que vocé faca a escolha. Para fixar a cor da TV, selecione o nimero 1 acionando 
a tecla 1 e o RETURN. Entdo a tela mostrara 16 barras verticais coloridas, como mostrado na 
fotografia da Figura 2.8, sO que a cores. 

Como se vé, as cores sdéo colocadas na parte de baixo da tela. Da esquerda para a direita as 
cores sao: 
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STANDARD COLOR NAMES 


RAC Me cae 
aa a 
eae Bess 


WHICH WOULD YOU LIKE? 


FIGURA 2.7. Menu do Programa COLOR DEMOSOFT. 
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FIGURA 2.8. Ajustando as Cores da TV. 
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BLAK 
MGTA 
DBLU 
PURP 

DGRN 
GREY 
MBLU 
LBLU 


APPLE II 


Preto BRWN 
Magenta ORNG 
Azul Escuro GREY 
Purpura PINK 

Verde Escuro LGRN 
Cinza YELO 
Azul Suave AQUA 
Azul Claro WITE 


Marron 
Laranja 
Cinza 

Rosa 

Verde Claro 
Amarelo 
Agua 
Branco 


Ajuste agora o contraste, brilho, cor e controles de tons da televisao, até que as cores tenham 
resolu¢ao aceitavel. Preste especial atencao em Purpura, Rosa, Amarelo e os trés tons de Azul. 
Quando terminar o ajuste das cores, acione a tecla RETURN e o menu reaparece. Pode-se 
escolher outro item qualquer para experimentar. Para terminar o programa acione CTRL-C (deve 
ser acionado com a tecla RETURN). 


COMPONENTES MISTURADOS 


Isto inclui as instrug¢des especiais de operacdo para componentes do sistema. Para outros compo- 
nentes do seu sistema, use 0 manual de operacdo especifico para aquele componente. Se for uma 
impressora, por exemplo, entdo deve ser lido o manual da impressora, porque as instrucdes variam 


com 0 tipo. 


COPIANDO COM ERROS 


O Apple I! € um aparelho maravilhoso, mas ele tem um problema comum a todos os compu- 
tadores. Falta de imaginacdo. Toda a instrucado que ele recebe deve estar rigorosamente correta ou 
ele nao operara corretamente. As conseqiiéncias de um erro variam entre extremos, podendo 


ser devastadoras. 


MENSAGENS DE ERRO 


Quando se digita alguma coisa errada e aciona a tecla RETURN, o Apple I! responde com um bip e 
uma mensagem critica. Frequentemente a mensagem da uma idéia do que houve de errado; mas 
pode nao dar também. O remédio, em geral 6 o mesmo em ambos os casos, repetir a linha. Uma 
completa lista de erros se encontra no Apéndice C. 
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CORRIGINDO ERROS DE DIGITACAO 


A medida que se digita no teclado do Apple ||, pode-se cometer erros. Algumas das teclas descritas 
anteriormente podem auxiliar a corrigir erros antes que se acione a tecla RETURN para entrar a 
linha. Sao elas as teclas <, >, REPT, CTRL-X e Esc-@: 


@ A tecla « volta o cursor de uma posicao e zera o caractere que passou. Os caracteres sao 
zerados da linha de comando embora permanecam na tela. 


A tecla > move o cursor para a frente, copiando as letras por que passa. 


A tecla REPT, usada em conjunto com * e ~, permite ir para a frente e para tras rapi- 
damente. 


O comando CTRL-X cancela a linha que esta sendo digitada. 


O comando ESC-@ limpa a tela e coloca o cursor na posicao mais 4 esquerda em cima. 


Vamos ver como se pode usar estas facilidades de edicdo. Suponha que se deseja digitar isso: 
LOAD COLOR DEMOSOFT 
No lugar disso, digita-se o seguinte: 
LOAS COLOR DEMOSOFT 


Existem duas chances. Ou aciona-se o CTRL-X para cancelar a linha de comando e reiniciar 
tudo ou se usa a tecla « para voltar e corrigir o engano. Acione e mantenha a tecla «. Acione 
entao REPT. O cursor corre de volta para o inicio da linha. Retire o dedo da tecla REPT, quando 
O cursor atingir o caractere errado. Lembre-se que 4 medida que o cursor voltou, todos os carac- 
teres que foram passados por ele foram apagados da memoria do computador. Se o retorno foi 
muito rapido, use a tecla > para alinhar o cursor com a letra errada S. Acione agora a tecla De 
pronto! A linha esta correta. Vocé sabe o que acontece se acionar a tecla RETURN agora? 


LOAD CE COLOR BDEMOSGOFT 
Todos os caracteres a direita do cursor vdo ser desprezados. 
LO arG 


Isso nao esta certo! Antes de acionar RETURN, deve-se mover o cursor para o fim da linha. 
Pode-se ainda redigitar a linha inteira, porém isso pode ocasionar outro erro. A tecla > (junto com 
REPT) move o cursor para o fim da linha, automaticamente reentrando os caracteres passados. 


Reset ACIDENTAL 


Mais cedo ou mais tarde, a tecla RESET sera acionada por engano. Isso é inevitavel, a menos que 
seu Apple I! requeira a digitagdo de CTRL-RESET ao invés de simplesmente RESET. Pode-se reduzir 
O azar retirando a capa de plastico da tecla e deixando apenas a haste (Figura 2.9). 

Pode-se tomar uma precaucdo ‘a mais e tornar a tecla RESET mais dificil de ser acionada. 
Peque uma borracha de 3/8 de polegada de’ didmetro interno, 1/2 polegada de diametro externo e 
1/8 de polegada de espessura. Remova a parte de cima da tecla RESET como mostrado na Figura 
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FIGURA 2.10. Protecao contra RESET Acidental: 





Fase Il. 


COMO O APPLE I! OPERA 33 


2.9. Coloque a borracha sobre a parte quadrada exposta da tecla como mostrado na Figura 2.10. 
Reponha a tampa da tecla. 


Voltando de um RESET 


O que se pode fazer apds um RESET acidental depende do que se estava fazendo no instante em 
que o RESET ocorreu, e do tipo de Apple I! que se esta usando. 

Qualquer programa usado, deve ter instrucdes especificas sobre o que fazer no caso de acio- 
namento acidental do RESET durante a execucao do programa. Certifique-se disso antes de iniciar 
a execucao. Se a tecla RESET for acionada durante a execucdo do BASIC, pode-se reiniciar 0 pro- 
grama desde o inicio. Este 6 um pequeno consolo durante algumas fases de programas aplicativos, 
desde que reiniciar pode dar muita dor de cabeca. 

Quando se aciona o RESET, o Apple II para tudo o que estava fazendo. O controle retorna 
para o teclado; aparece o caractere de entrada e o cursor piscando na parte de baixo da tela. Se o 
programa é o BASIC pode-se voltar 4 execucao dando 0 comando RUN. Aquilo que foi processado 
antes do RUN provavelmente se perdera. 

Se for no Monitor ( *), pode-se voltar ao BASIC digitando-se CTRL-C a menos que se esteja 
usando Applesoft baseado em disco ou cassette. Para sair do Monitor para Applesoft em disco, 
digite o seguinte comando do Monitor: 


#3006 
Para pular do Monitor para o Applesoft em cassette, use 0 seguinte comando do Monitor: 


1G 


PRECAUCAO: Certifique-se de que usou o comando correto. Se no estiver certo sobre o que 
usar, pergunte a alguém mais experiente. Use 0 comando errado e estara perdido. O programa 
precisara ser recarregado, o Applesoft e possivelmente até o DOS. 
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Programando em Basic 


Este capitulo ensina como iniciar a execucdo de seus proprios programas em BASIC no Apple II. 

O BASIC é uma linguagem de programacao. Como outra linguagem do tipo, ela consiste num 
conjunto de comandos, que sao combinados para criar programas. Um programa define a tarefa 
que se deseja que 0 computador execute. 

Poderfamos ensina-lo a programar em BASIC, primeiro forcando o aprendizado de todos 
Os comandos, um a um. Porém isso nao daria grande resultado, pois os comandos nao possuem, 
individualmente, muito significado. O estudo de comandos individuais de BASIC rapidamente se 
degenera em estudo de regras arbitrarias que nada dizem ou significam, em termos de progra- 
macdo e pratica em construcdo de programas. Assim, a definicao rigorosa de todos os comandos 
da linguagem BASIC foi deixada para 0 Capitulo 8. Va ao Capitulo 8 quando sentir necessidade, 
porém nao o leia sem ter aprendido os conceitos deste capitulo. 


INICLANDO COM BASIC 


Existem duas versdes diferentes de BASIC disponiveis para o Apple II. Alguns modelos possuem 
o Integer BASIC, outros tem o Applesoft, e outros ainda dispdem de ambos. Por ora, nao se preo- 
Cupe sobre que versao esta usando, se Integer BASIC ou Applesoft. Mais tarde, quando as diferen- 
¢as se tornarem significativas, entraremos em mais detalhes. 


O Caractere de Entrada do BASIC 


O Apple I! é uma mdquina multilingual. Se se deseja programar em BASIC, deve-se inserir instru- 
¢des nessa linguagem. Existem instrucdes sobre como iniciar a operacdo com o BASIC no Capi- 
tulo 2. Vamos fazer uma rapida revisdo. 

No Apple Il com o Monitor de inicio automatico, precisa-se apenas ligar a maquina e acio- 
nar o RESET ( CTRL-RESET em algumas vers6es do teclado). 

Se o seu Apple I! ndo tem inicio automatico, ligue-o e acione CTRL-B e RETURN. 
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O caractere de entrada 4 margem esquerda e o cursor informam em que posicao o BASIC 
se encontra. Se for Integer BASIC o caractere é ‘>’, se Applesoft é “|” 


MODO IMEDIATO E PROGRAMADO 


Antes de nos preocuparmos em como pular do Integer BASIC para o Applesoft e vice-versa, vamos 
dar uma olhada em comandos simples de BASIC que podem ser usados em ambas as versoes. 
Alguns dos exemplos deste capitulo usam Integer BASIC (>) enquanto outros usam o Applesoft 
(]). Pode-se treinar os exemplos em ambas as versOes, nado importando a sua versao especifica, 
a menos que se especifique o contrario. Os exempios em que nao aparece o caractere de entrada, 
podem ser usados em ambas as vers6es. 


IMPRIMINDO CARACTERES 


Quando se inicia pela primeira vez com a operacdo do Apple || em BASIC, se esta no modo ime- 
diato, também chamado modo “‘direto”’ ou ‘‘calculadora’’. Neste modo, o computador responde 
imediatamente as instrucdes que recebe. Tente escrevendo o exemplo: 


PRINT “PROGRAMANDO EM MODO DIRETG” 


Ndo se esqueca de acionar a tecla RETURN, apos a Ultima aspe. O Apple || imprime a seguinte 
mensagem: 


FROGRAMANDO EM MODO DIRETO 


Se 6 impressa a mensagem ?SYNTAX ERROR ou ***SYNTAX ERROR, isso esta dizendo que o 
comando nao foi entendido. Provavelmente houve erro de digitacado da palavra PRINT. Se for 
impresso apenas o numero O ao invés da mensagem, indica que se esqueceu de colocar a primeira 
aspa. Em ambos os casos pode-se redigitar 0 comando, porém com mais cuidado! Os computado- 
res sdo muito meticulosos com sintaxe e pontuacao. Um pequeno erro pode fazer o computador 
reclamar, ou pior ainda, fazer as coisas erradas. 

Um comando como o acima faz com que o computador imprima tudo que estiver contido 
entre as aspas na tela do video. 

Existe um limite para o tamanho da mensagem que pode ser colocada entre as aspas. O limite 
é diferente para o Integer BASIC e o Applesoft, mas em ambos os casos ele excede o tamanho da 
tela. Isso quer dizer que o comando pode ocupar mais de uma linha da tela. Os comandos de tama- 
nho grande automaticamente pulam para a linha de baixo da tela. Tente este exemplo: 


PETAT “SOB CTROUNSTANETAS NORMATS, © Hd 
MEN PODE SER CONSTDERADO LOULO” 
SOB CONDICGES NORMAIS © HOMEM PODE SER 


MONS TORR ADO LaOulce 
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O Integer BASIC permite até 120 caracteres. Se este limite for excedido, aparece a mensa- 


gem *** TOO LONG ERR apos acionar o RETURN. 
O Applesoft permite até 255 caracteres. Quando se chega ao limite, o Apple I! da um dip. 


Quando o limite é excedido, o Apple I! imprime uma barra (\) e automaticamente despreza a 
entrada, como se tivesse sido acionado o CTRL-X. 


IMPRIMINDO CALCULOS 


Pode-se usar o Apple |! em modo imediato como uma calculadora; ele responde diretamente com o 
resultado de calculos aritméticos. Tente estes exemplos: 


PRINT 4446 Adicao 

4 

PRINT S3Q0-427 Subtrac¢ao 
PRINT WOOR23 Multiplicacdo 
200 

PRINT 94/42 Divisdo 

B 

PRINT 3°2 Exponenciacao 
y 

PRINT e437 9-HOOD Combinacao 
~& OC) 


A resposta correta se encontra na linha abaixo de cada um dos comandos. Veja que nao sao neces- 
sarias aspas nesses comandos. Sabe o que acontece se elas forem colocadas? Tente se nao souber. 

O Integer BASIC tem um limite maximo e minimo para o tamanho dos nimeros nos calcu- 
los. Se o valor 6 maior que 32767, em qualquer ponto durante os calculos, aparece a mensagem 
*** > 32767. Se o valor 6 menor que —32767, aparece a mensagem — *** > 32767. Alguns exem- 
plos deste tipo de erro s4o mostrados abaixo. O Ultimo exemplo se refere a uma divisdo por zero. 


YPRINT <32767~2 


“S28 2Ge/7G7 ERR 


PROGRAMANDO EM BASIC 37 


SPRINT 20484 


He FSS7S7 ERR 


SPRINT TOO 
eee OGLE? ERR 


As fracdes decimais nado sao permitidas no Integer BASIC. Assim, se for dada uma instrucao 
para divisdo com resultado nao inteiro, o resto @ desprezado. Por exemplo, teste este calculo: 


O Applesoft permite operacdo com fraciondrios. Os valores numéricos podem ter até nove 
digitos significativos, incluindo parte inteira e decimal. Isso quer dizer que niimeros com mais de 
nove digitos sdo arredondados para nove ou para o menor digito diferente de zero. Estes exemplos 
ilustram como ele opera: 


IPRINT 12434567696 Arredondado para cima 
124345679 
JIPFRINYT (2,545 47894 Arredondado para baixo 


1a S4aOG7 BF 


Se for tentado algum calculo no modo imediato dentro do Applesoft, pode acontecer que o 
resultado venha em notacao cient/ffica. 


PRINT T2345467894 2% 


Se houver dificuldade em entender a notacao cientifica, fique com os calculos simpies por enquan- 
to. Abordaremos mais detalhes sobre notacao cientifica e valores numéricos ainda neste capitulo. 


Comando PRINT Abreviado 


O Applesoft permite que se abrevie o comando PRINT com o ponto de interrogacao (?). Aqui 
estao alguns exemplos que podem ser tentados: 


1? °°O TEMPO Passac 


. TEMPO PASSA 
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MENSAGENS DE ERRO 


Dissemos antes que o Apple II emite varias mensagens de erro quando aparecem situacdes em que 
ele nao consegue operar. Ele gera o bip para chamar a atencao para o fato de que algo esta errado, 
e tenta diagnosticar o problema. Sua capacidade de diagndstico é limitada, de forma que nao se 
deve esperar uma andalise definitiva sobre os erros. Existem cerca de 35 mensagens que o Apple II 
pode usar em resposta ao universo de erros e suas combinacoes. 

Ao longo deste capitulo e do resto do livro faremos meng¢ao a alguns dos erros que podem 
ocorrer em situacdes especificas, especialmente as mais comuns. Todas as mensagens de erro estado 
listadas em ordem alfabética no Apéndice C. 


Formato da Mensagem de Erro 


As mensagens de erro tém um formato ligeiramente diferente entre as duas versdes do BASIC, 
como mostrado abaixo: 


JPRNIT “A LAYA CORRE” 


VSYNTAX ERROR 


bani 


PRNIT “A LAUA CORRE” 


Hee SYNTAX ERRGR 


ESPACOS EXTRA EM BRANCO 


Se existe preocupacdo quanto 4 questéo de onde colocar espacos em branco, nao se preocupe. 
O Apple II interpreta uma linha de comando BASIC pelos elementos nela colocados. Espacos, ou 
brancos, sao irrelevantes. O Unico lugar em que deve ser colocado espaco é dentro das aspas, onde 
se deseja espaco como parte da mensagem. 


COMANDOS, LINHAS E PROGRAMAS 


Um programa consiste de um ou mais comandos que dao ao Apple || uma exata e completa defi- 
ni¢ao da tarefa que deve ser executada. Se a tarefa 6 pequena e simples, o programa também sera 
pequeno e simples. As instrugdes de modo imediato que abordamos ha pouco sao, de fato, peque- 
nos programas. Cada um tem apenas uma instru¢do — um comando do Apple !1. Sao casos triviais. 
Muitos programas tém 10, 100, 1000 ou até mais comandos. Considere os seguintes comandos: 


PROGRAMANDO EM BASIC 39 


FRINT “RATOS” 

RATOS 

PRINT “SOBRAS” 

hOBRAS 

PRINT “ E LAGARTOS" 
E LAGARTOS 


Cada um desses programas em modo imediato imprime uma linha na tela. Cada programa tem exa- 
tamente um comando e exatamente uma linha. 

O Applesoft permite que se coloque mais de um comando em cada linha. Separam-se os co- 
mandos na mesma linha pelo sinal de dois pontos ( : ). Compare este programa em modo imediato 
com o exemplo acima: 

IPRINT “RATOS°IPRINT “COBRAS’ SPRINT “ E 
Lauak TOS” 
RAT OS 


SOERAS 


mE LAGAR TOS 


Este programa de trés comandos e uma linha imprime as mesmas trés linhas de texto dos trés pro- 
gramas independentes do exemplo anterior. 

Nao existe um limite especifico para o nimero de comandos que se pode colocar numa linha 
do Applesoft. Lembre-se que uma linha nado pode ter comprimento superior a 255 caracteres. Se 
se digita uma linha muito longa, o computador comeca a emitir o b/p a partir do caractere de 
numero 248 informando que esta chegando ao limite. Se o limite é atingido, a linha é automatica- 
mente cancelada, como se fosse digitado CTRL-X, e deve-se recomecar. Ele nao executa nenhuma 
das instrucGes colocadas naquela linha. Desta forma vé-se que existe um limite claro do que se 
pode fazer em uma linha de comando no modo imediato. 


Uma Linha de Comando no Applesoft 


Pode-se colocar um bocado de programa em uma linha dentro do modo imediato, gracas a habili- 
dade que o Applesoft tem em operar com mais de um comando dentro de cada linha de 255 carac- 
teres. Por exemplo, vejamos o exemplo abaixo: 


JEOR Ted TO SO0n7° ATS INEXT# °° ACABOUT 


Sem saber o que este miniprograma faz exatamente, digite-o no teclado exatamente como 
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mostrado, finalizando com RETURN. Se a digitacao for feita corretamente, vai aparecer a letra A 
em 20 linhas de 40 colunas cada, seguida pela palavra ACABOU!, na 214 linha. 


AA RR ARARARAAAARARAAAARARAAAAAARAAARAAAAARAA 
AR AAR AAARARARAAAARAARAARAARAARRAARARARARAAAAAA 
AR ARAARARARAARARARRAAARAARAARAAAAAAAAAAA 
ARARARARAARARAARAARARARARARARAARAARAAARARAA 
AR RAR AAR RARARAARARARARAARAAAARARAAAAAAARAAAA 
AARRARAARAARARARARAAARAARAARAARARARARARAAR 
ARARAAARAAARAARAARAAARAARAARAAAARAARARARAAAARA 
AA RAR AARAARARAARAAARARARAARAAAAAARAARARARAAARAA 
ARARARARAAARARAARARARAARARAAAARARARARAAARAA 
AR RAR ARAARRAARAARAARAAARAARAARARAAAAAARAAARAA 
AR BRARARAARAARAAAARARAARAARAARAARABRAAAAAARAAAAA 
AR ARAARAAARARARAAAAAAARARARAARARARARAAAAAAA 
FARRAR RAR AR AARBRABRAARBARRARAAAARAARAAAARAA 
AARBRARAARARAAARAARAAARAAARAARRAARAAAARAAAAAARAA 
AARARARARARARARABRARAARARAARAAARAARAAARAARAAA 
AR AAR AAR RARAARAAAAAARAARAAAAAAAARAAAAAAASA 
AR AAR RARARARARARAARAAARAARAAAARAARAARAABAA 
AR ARAARARAARAAAAAAAAARARAABRAARAARARAARAAARA 
AAARAARARARAARAARARAAAAARAARARAARRAARAAARA 
RARAAAARAARARAAAAAAAARAAAAAARAAAAARARAAAARA 
AL ABGU! 


A linha de programa fica colocada no alto da tela do lado esquerdo. Isso porque o programa 
mostra um nimero de linhas suficiente para posicionar a linha no alto da tela, porém sem elimi- 
na-la. 

Quando o programa de uma linha descrito acima termina sua execucao, o caractere de 
entrada do Applesoft é colocado com o cursor a seu lado na linha de baixo da tela. 


MODO PROGRAMADO 


A forma de programacao apresentada acima é educacional, Util e interessante; porém tem limi- 
tagdes sérias, especialmente em Integer BASIC, com sua limitagdéo de um comando por linha. 
Outra desvantagem do modo imediato é que se deve redigitar o programa a cada vez que se deseja 
roda-lo. Existem algumas técnicas avancadas de edicdo que veremos de forma rapida e que permi- 
tem usar novamente o programa no momento em que ele aparece na tela. Mas, de qualquer forma, 
este fato ainda é uma desvantagem. 

O que se precisa é uma forma de se entrar com varias linhas de programa e manté-las dispo- 
niveis de forma que se possa escrever rotinas que s4o muito complexas para programas de apenas 
uma linha. 

Existe uma forma de contornar estes problemas que se verificam no modo imediato, que é 
escrever programas no chamado modo programado, também chamado indireto. No modo progra- 
mado, 0 computador aceita e guarda o programa em sua memoria, mas nado executa nenhuma 
das instrucGes mandadas até que se dé a ordem para executa-las. Pode-se colocar tantas linhas de 
programa quanto se desejar. Entao, entrando com a ordem apropriada, o computador executa a 
operacao especificada pelo programa entrado. 
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Execugao de Programa 


Dissemos que 0 computador executa ou roda um programa quando ele executa as operacées espe- 
cificadas por ele. 
No modo imediato, o programa é executado no momento em que se aciona a tecla RETURN. 
Em modo programado deve-se dar o comando RUN para executar o programa. Cada vez que 
se faz isso, oO programa é executado novamente. 


Limpando Programas Velhos 


Devido ao Apple II guardar os programas na memoria dentro do modo programado, deve-se colo- 
car uma ordem especial para apagar os programas velhos antes de se executar a digitacdo de um 
novo. Para fazer isso deve-se dar o comando NEW. Se esta ordem for esquecida, um novo programa 
entrado vai se misturar com o velho. 


Finalizando Programas Corretamente 


O fim de um programa em modo imediato é Obvio. Isso nado acontece no modo programado, como 
veremos. O comando END, dentro do programa diz ao BASIC para terminar a execucao do pro- 
grama e retornar ao modo imediato. Assim o comando END deve ser 0 Ultimo comando dentro de 
um programa a ser executado. 

O Applesoft ndo requer o comando END. Ele finaliza o programa automaticamente apds 
executar todas as instrucdes colocadas. 


Ndameros de Linha 


Os numeros de linha tornam o modo programado possivel. Um numero de linha é simplesmente 
um numero de um, dois, trés, quatro ou cinco digitos, digitado no inicio de uma linha de coman- 
do. Este numero de linha é a Gnica diferenca que existe entre uma instrucao no modo programado 
e imediato. Existem algumas instrucdes que sO podem ser usadas no modo imediato e outras que 
sO se usam no modo programado; isso sera visto mais tarde em detalhes. 

Vejamos um exemplo de programacdo em modo programado: 


> MEU 
STO PRINT “TODO OTA, TODA HORA” 


720 END 


TODG DTA. TODA HORA 


Cada nimero de linha deve ser Gnico. Nao pode haver duas linhas em um programa com o 
mesmo numero. Se isso for feito, o computador guarda a ultima linha digitada. Para ver isso colo- 
quemos o seguinte programa: 
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>NEW 

+40 PRINT “PRIMETRA LINHA 10° 
910 PRINT “SEGUNDA LINHA 70° 
20 END 

sRUN 


SEGUNDA LINHA 10 


Os nimeros de linha determinam seqiéncia das linhas de programa dentro do BASIC. A 
primeira linha deve ter o numero menor, enquanto que a Ultima deve ter o numero maior. Mesmo 
digitando as linhas fora de ordem, o Apple II rearranja as linhas na sequéncia pelos numeros das 


linhas. Vejamos um programa, com os nimeros das linhas fora de ordem: 


> NEW 
x30 PRINT “TRIATAS 


290 PRINT “EZ” 

P20 PRINT “OINTE” 

240 PRIAT “QUARENTA” 
x20 END 


> RUN 


DE 2 
WINTE 
TRIMNTS 
QUAREN TA 
Para provar que o Apple II ndo perdeu o programa colocado dentro do modo programado, 
limpe a tela com o comando Esc-@ e mande rodar o programa novamente. 


» ~«— Acione Esc-@ e RETURN 

>FLIN 

DEL 

WINTE 

TRINTA 

QUAR EM TA 

Pode-se adicionar comandos a um programa que esteja dentro da memoria do computador. 

Elas podem ser adicionadas no inicio, no fim ou em qualquer parte do meio do programa colo- 
cando o numero de linha que vai posicionar a instrucao onde ela é necessaria. Vamos supor que se 
deseja colocar uma linha no inicio do programa acima. Como nao foi dado o comando NEW, o 
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programa ainda esta dentro da memoria do Apple I1. Como a menor linha de programa no exem- 
plo é 10, qualquer comando com nimero de linha inferior a 10 sera colocado no inicio do progra- 
ma. Vejamos: 


2 PRINT “CINCO” 
> RUIN 


LINCO 
DE.Z 
VINTE 
TRINTA 
QUARENTA 


E ‘uma boa pratica comecar o programa original com o nimero de linha 10 ao invés de O! 
Recomenda-se iniciar o programa com um numero de linha um pouco alto e pular nimeros entre 
uma linha e outra, de forma a deixar espacgo para a digitagdo de outras linhas que forem necessa- 
rias, mais tarde. 


Linhas de Programa Multiinstrucdo 


Pode-se colocar mais de uma instrug¢ao dentro de uma linha de programa. O primeiro comando 
segue o numero da linha. A segunda instrucao segue a primeira com o caractere dois pontos ( :) 
entre as duas. Este sinal ( :) separa as instrucdes dentro de uma linha de mais de uma instrucao. 

O Integer BASIC permite que se coloque mais de uma instrucao em cada linha dentro do 
modo programado, 0 que nao acontece no modo imediato. O comprimento de cada linha é de 
aproximadamente 150 caracteres. O comprimento exato varia de acordo com o conteiido da linha. 
Se é digitada uma linha muito extensa, o Apple I! apresenta a mensagem *** TOO LONG ERR, 
e a linha deve ser redigitada. 

No Applesoft sao permitidas linhas de multiinstrug¢ao tanto no modo imediato quanto no 
programado. Em ambos 0 comprimento maximo é 255 caracteres, como ja foi dito. 


Listando as Linhas de Programa 


Pode-se ver as linhas de programa que o computador guardou dentro da memoria digitando-se o 
comando LIST. Tente agora. Se nao foi digitado NEW depois do Ultimo exemplo, pode-se ver as 
linhas de comando do programa anterior mostradas na tela: 


LIST 


2 PRINT “CINCO” 
410 PRINT *OEZ¢ 
20 PRINT “VINTE" 
320 PRINT “TRINTA* 
40 PRINT “QUARENTA” 
20 END 
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Isso se chama /istagem do programa. Existem variacdes do comando LIST que permitem listar uma 
Unica linha do programa ou um conjunto delas. Esta Ultima op¢ao é Util quando se tem programas 
longos cujas listagens ndo cabem na tela de uma sO vez. Com o exemplo de cima, tentemos o 
comando: 


Kot AQ 
Ele causa o aparecimento de: 
TH) PRINT *DEZ” 


Para listar varias linhas em seqiiéncia, deve-se especificar as linhas inicial e final no comando, 
como neste exemplo: 


Loot 20% 40 
aU PRINT “VINTE” 
20 PRINT “TRINTA” 
“Q PRINT “QuaAREN TA* 


Em Applesoft pode-se listar todas as linhas de programa até uma especificada, inclusive. 
Pode-se também iniciar a listagem numa linha especifica e ir até o fim do programa. Aqui estao 
exemplos das duas variagdes do comando LIST: 


dtek ole 18 
~ PRINT “CINEO* 
tO PRINT *DEZ” 


ILISTad, 

30 PRINT “TRINTA‘ 
4) PRINT “QUARENTA” 
SO) END 


Interrompendo a Listagem 


Pode-se parar a listagem antes que ela termine digitando-se CTRL-C. Isso é especialmente Util para 
interromper listagens interminaveis quando o programa é muito grande. 

Se o Apple I! tem o Autostart Monitor, pode-se suspender, ou parar temporariamente a 
execucao da listagem digitando-se CTRL-S. Ela continuara a ser executada com o acionamento da 
barra de espaco. O CTRL-S permite que se veja um trecho de listagem do programa de cada vez. 


Numeracgao Automatica de Linha 


O Apple {1 automaticamente renumera as linhas de programa do Integer BASIC. Usa-se 0 comando 
AUTO para realizar esta operacao. Desta forma o computador vai fornecendo o proximo numero 
de linha a cada vez que se aciona a tecla RETURN. Ele nao avanca para a proxima linha se encontra 
um erro na linha terminada, ou até que se acione a tecla RETURN. 

Para sair da numeracdo automatica de linhas, digita-se CTRL-X. Isso cancela a inser¢cao de 
numeros de linha pelo computador. Em seguida, digita-se o comando MAN. 
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Para ilustrar como os comandos AUTO e MAN funcionam, vejamos o exemplo: 


PALTO TOO0 


SAIN PRINT “QUANTAS Ja&rRDAS TEM UMA MILHA?* 
LOD Acione apenas RETURN 
PAO PRIMT Seego73 


Ree SYNTAX ERR 


TO4N PRINT SGe073 
“420°. Acione CTRL-X 
: MeN 


Como se pode ver no exemplo, o AUTO exige que se informe a partir de que linha deve 
comecar a numeracdo automatica. Pode-se especificar também o incremento a ser dado entre cada 
linha. O exemplo abaixo ilustra essa opcao. 


SAHTO AN. 10 

-INOO PRINT “SerR OW NAO SER” 
PFO Acione CTRL-X 

> MAN 


Neste exemplo, os nimeros das linhas tem incremento de 100. Se for omitido o incremento, o 
Apple II utiliza 10 como visto no exemplo anterior. 


GUARDANDO PROGRAMAS EM CASSETTE 


Um gravador cassette fornece meios de guardar um programa introduzido no modo programado 
fora do computador e mais tarde carrega-lo de volta na memoria. Suponha que se tem o seguinte 
programa na memoria: 


4 PRINT “MUTT 
20 PRINT “Sane 
0 PRINT “PoR- 
Gt) PRINT "UM" 

SO PRINT “TosTag* 


41) END 


Para salvar este programa, coloque uma fita cassette no gravador. Rebobine até o inicio, acione os 
bot6es de RECORD e PLAY simultaneamente no gravador cassette e digite o comando seguinte 
no teclado: 


SAVE 


O Apple II vai dar um b/p quando iniciar a gravagcao do programa em fita e outro quando terminar. 
Aperte o botaéo STOP no gravador apés ouvir o segundo Dip. 
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Nesse ponto digite NEW seguido de LIST para limpar o programa da memoria principal e 
verificar que ele se foi. Para carregar o programa de volta da fita para a memoria, primeiro rebobine 
a fita até o inicio. Acione entéo o botaéo PLAY do gravador cassette e digite o sequinte comando 
no teclado: 


LOAD 


O Apple II toca um bip no instante em que inicia a leitura do programa da fita para a memoria e 
outro quando termina a leitura. Deve-se parar manualmente o gravador apos ouvir o segundo dip. 
Use o comando LIST para verificar se o programa esta dentro do computador. 

No Capitulo 5 veremos como guardar e carregar programas no disco, que é mais conveniente 
que o Cassette. 


Guardando Varios Programas em Uma Unica Fita 


Como se pode ver executando o exemplo acima, nado é necessdario muita fita para se guardar um 
programa. Os programas maiores requerem mais fita, porém em geral existe espaco em um Cassette 
para se guardar varios programas em BASIC. Pode-se guardar os programas em forma sequencial 
numa fita: o segundo apos o primeiro, o terceiro depois do segundo etc. 

Carregar o segundo, terceiro, quarto e subseqiientes programas do cassette nado é uma tarefa 
direta, como é o primeiro. Apos rebobinar a fita até o inicio, deve-se passar o primeiro programa 
para acessar 0 segundo, passar o segundo para acessar o terceiro e assim por diante. Pode-se obter 
isso dando o comando LOAD repetidas vezes até que o programa desejado seja lido para a memo- 
ria. Esse 6 um processo demorado, mas funciona. 

Pode-se aumentar a velocidade consideravelmente se o gravador cassette tiver um contador 
de fita. Reinicie o contador para 0 quando rebobinar totalmente a fita. Apos gravar o primeiro 
programa anote o numero indicado no contador de fita. Essa sera a posicao inicial para leitura do 
segundo programa. Grave o segundo programa e anote a leitura do contador de fita no final da 
gravacdo (sera a posi¢ao inicial de leitura do terceiro programa). 

Agora, para carregar 0 segundo programa, rebobine a fita ao inicio e zere o contador. Dé 
avanco rapido na fita com o botao FAST FORWARD até posicionar o contador de fita no inicio 
do segundo programa. Pode-se usar 0 botaéo REWIND para voltar a fita se ela avancou demais. 
Agora basta usar o comando LOAD para ler o segundo programa. 


TROCANDO DE BASIC 


Em varias vers6es do Apple II, pode-se escolher entre programar em Integer BASIC ou Applesoft. 
As razGes de se trocar um BASIC por outro ficarao claras no decorrer deste capitulo. Ja vimos, por 
exemplo, que’o Integer BASIC proporciona numeracao automatica de linhas, o que o Applesoft 
nao faz. Por outro lado, o Applesoft permite trabalhar com valores numéricos fracionarios, e o 
Integer BASIC nao. 

Muitas versGes do Apple I! operam ambos os BASIC’s, porém nem todas. O Apple II stan- 
dard, por exemplo, tem apenas o Applesoft. O processo para trocar de uma versao do BASIC 
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para outra varia de acordo com o modelo de Apple |! utilizado, e dos opcionais que estao conec- 
tados nele. 

Com o Language System da Apple, tem-se acesso imediato a ambas as verses do BASIC. 
Estando em Integer BASIC digite FP para passar para Applesoft. Dentro do Applesoft digite INT 
para acessar o Integer BASIC. 

O cartéo com o Applesoft em “firmware’’ também permite acesso imediato a ambas as 
versoes do BASIC. Ele tem uma chave que se acessa através do slot atras do Apple || e determina 
a versao do BASIC. Ligando-se 0 computador com a chave para baixo, acessa-se 0 Integer BASIC. 
Com a chave para cima, ao se ligar o Apple I! acessa-se o Applesoft. Fora o posicionamento da 
chave, pode-se digitar FP para acessar o Applesoft e INT para acessar o Integer BASIC se 0 cartao 
estiver instalado. 

No Apple || standard é facil acessar o Integer BASIC. Acione a tecla RESET e digite CTRL-B. 
Nesta versdo do Apple II é mais dificil se ter o Applesoft, uma vez que o programa vem em fita ou 
disco. Deve-se fornecer as instrucdes necessdrias para ele carregar o Applesoft da fita ou do disco. 

Antes de se usar o drive de disco deve-se dar o boot do Sistema Operacional em Disco (DOS) 
como foi descrito no Capitulo 2. Deve-se fazer isso a cada vez que se liga o computador. Para 
repassar rapidamente, estas sao as instrucGes para dar o boot do DOS no Monitor e no Integer 
BASIC. 


we,  Acione CTRL-P e RETURN 
SE RES 


Uma vez dado o boot, pode-se colocar o Apple I! no Applesoft a partir do Integer BASIC, 
colocando o disco com o Applesoft no drive de disco e digitando FP. Em poucos segundos o carac- 
tere de entrada do Applesoft ( |) aparece na tela. 

Pode-se também ter o Applesoft em fita. O processo completo para sua leitura é descrito no 
Capitulo 2. Em resumo, deve-se pdr o cassette com o Applesoft no gravador cassette, acionar a 
tecla PLAY e dar o comando LOAD dentro do Integer BASIC. Em 1 a 2 minutos, aparece a nota 
de Copyright e 0 caractere de entrada na tela. 

Dentro do Applesoft, pode-se voltar ao Integer BASIC digitando o comando INT. Caso se 
deseje voltar ao Applesoft, usa-se 0 comando FP com o drive de disco, ou o LOAD com a fita 
cassette. 


TECNICAS AVANCADAS DE EDICAO 


No Capitulo 2 vimos algumas formas de corrigir erros durante a digitag¢ado da linha de comando, 
antes do acionamento da tecla RETURN. Vamos, rapidamente, rever as técnicas apresentadas. 


A tecla < volta o cursor de um espaco e limpa o caractere passado. Os caracteres sao elimi- 
nados da linha de programa, ainda que continuem aparecendo na tela. 


A tecla -> move o cursor para a frente, copiando (reentrando) o caractere passado. 
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A tecla REPT, usadaemconjunto com as teclas < e —, permite aida para a frente e para 
tras mais rapidamente. 


Ocomando CTRL-X cancela a linha que esta sendo digitada. 


O comando Esc-@ limpa a tela e coloca o cursor na linha superior a esquerda. 


Vamos agora ver outras formas de editar linhas de programa. Estes novos métodos sao parti- 
cularmente Uteis quando se deseja modificar as instru¢des no modo programado (ou seja, aquelas 
com numero de linha). 


ELIMINANDO LINHAS DE PROGRAMA 


Para eliminar uma linha inteira, digite seu nimero seguido imediatamente pela tecla RETURN. Ao 
listar © programa, nota-se que tanto o numero da linha quanto o seu contetido nado mais fazem 
parte do programa. Aqui esta um exemplo: 


> NEU 

,100 PRINT “MEW COoRALAO” 
7110 PRINT “NAG SET PORQUE” 
420 PRINT “BATE FELIZ” 
>130 PRINT “QUANDO TE VE” 
*140 END 

ra48 

+130 


Pha das | 
{QO PRINT “MEU CoRACAG* 
teu PRINT “GATE FELG2” 
140) END 
Pode-se usar 0 comando DEL para eliminar um bloco de linhas de programa. Por exemplo: 
POEL t410-1740 
hak OT 
JOO PRINT “MEU CORAL AG" 


O comando DEL 110,140 eliminou todas as linhas de programa, iniciando na linha 110 e termi- 
nando na 140. Mesmo que a linha 110 nao exista, todas as linhas entre 110 e 140 sao retiradas. 


ACRESCENTANDO LINHAS DE PROGRAMA 


Pode-se acrescentar novas linhas de programa em qualquer ordem, a qualquer tempo. Seus nimeros 
de linha vao determinar a posicdo que ocuparao no programa. O Apple |! automaticamente ordena 
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as novas linhas e aquelas ja existentes na memoria. Adicionemos as linhas 110, 120 e 130 no 
exemplo acima. 


>TO PRINT “NAO SET PORQUE” 
T20 PRINT “GATE FEL LZ” 
U0 END 
031 
TOD PRINT “MEU CORACAQ” 
Ti PRINT “NAO SET PORQUE” 
420 PREOEINT “GATE Fria” 
420) END 


ALTERANDO LINHAS DE PROGRAMA 


A forma mais simples de se alterar uma linha de programa é redigita-la. Essa nado é uma boa solucao 
por varios motivos. Redigitar é uma tarefa que consome bastante tempo e as chances de se errar na 
digitacao sao grandes. Felizmente ha uma maneira de se modificar as linhas de programa que estado 
na memoria sem ter que redigita-las. A forma pela qual se permite isso, existente tanto no Integer 
BASIC quanto no Applesoft, tem como base o fato de que tudo que é mostrado na tela esta vivo. 
Pode-se editar qualquer coisa que esteja na tela. Usando a tecla Esc em conjunto com varias outras 
teclas, pode-se mover o cursor ao longo de todas as posicdes da tela. Isso faz com que se possa 
mover o cursor para o inicio de qualquer linha que esteja presente na tela. Pode-se entao usar a 
tecla ~ para copiar as partes ndo modificadas do programa. Pode-se substituir, inserir ou eliminar 
Caracteres em qualquer ponto da linha. 

Aqui esta como isso funciona. Primeiro usa-se 0 comando LIST para fazer aparecer na tela 
aquilo que se quer modificar. Perceba que o comando LIST coloca espacos extra, quando mostra 
as linhas de programa. (Para tornar o programa mais legivel.) Esses espacos extra podem tornar 
mais dificeis de editar linhas de programa muito longas. Para livrar o comando LIST desses espatos 
extra que podem causar problemas na edicdo, limpe a tela (usando Esc-@) e digite o seguinte 
comando misterioso: 


PORE. 32:33 
Além de suprimir os espacos extra em branco, este comando faz reduzir o tamanho da tela 


de 40 para 33 caracteres. Veremos 0 comando POKE em mais detalhes no Capitulo 4. Para fazer 
voltar a tela ao seu tamanho normal, digite: 


PORE 33, 40 


Movendo o Cursor 


Para mover o cursor pela tela, deve-se acionar duas teclas em seqiéncia. Primeiro acione a tecla Esc 
e depois A, B, C e D, toda vez que desejar colocar o cursor uma posic¢do para a direita, esquerda, 
cima ou baixo. A Figura 3.1 ilustra como as quatro possibilidades afetam o movimento do cursor. 


50 APPLE II 





FIGURA 3.1. Movimento do Cursor. 





FIGURA 3.2. Movimento do Cursor (Verséo Monitor Autostart). 


Com o Autostart Monitor, pode-se usar ainda as teclas |, J, K e Mem conjunto com Esc para 
mover o cursor. Pela forma como essas letras estado situadas no teclado, elas formam um painel de 
controle direcional, como mostrado na Figura 3.2. 

Existe uma importante diferenca na forma como a tecla Esc opera com I, J, Ke M. Acione 
Esc e o Apple I! vai para o modo de edi¢ao. Acione entao |, J, K ou M para mover o cursor ao 
largo da tela — sem necessidade de acionar Esc toda vez. O Apple I! fica no modo edicao enquanto 
se acionar qualquer uma das teclas |, J, K, M ou REPT. Isso permite mover o cursor em mais de um 
espaco sem ter necessidade de digitar o Esc a cada vez. Para sair do modo de edi¢ao, aciona-se 
qualquer tecla que no seja |, J, K, M, REPT, CTRL ou SHIFT. 

Pode-se usar a tecla REPT para fazer o cursor se mover longas distancias na tela com pouca 
digita¢gao. 


Trocando Caracteres 


Trocar um caractere por outro é simples. Posiciona-se o cursor sobre o caractere a ser trocado e 
digita-se o substituto sobre ele. Por exemplo, com o cursor posicionado no exemplo abaixo: 
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100 PRINT “TEMPO ESTIMADG DE aH E GAB AY 
pode-se digitar DESEMBARQUE, obtendo-se: 
{O00 PRINT “TEMPO ESTIMADO DE DESEMBARGQUE’T 


Adiciona-se RETURN para efetivar a modifica¢ao. 


Eliminando Caracteres 


Pode-se efetivamente eliminar caracteres individuais colocando-se espacos em branco sobre eles. 
Deve-se lembrar que no BASIC os espacos em branco nao tém maior significado, a menos que 
estejam entre aspas, quando fazem parte de textos. Pode-se usar as teclas Esc e A (a tecla K no 
modo edicado) para mover o cursor para a frente. Diferentemente da tecla —, as teclas Esc-A 
e Esc-K nao recopiam os caracteres que sao passados. Se os caracteres que se deseja eliminar 
estiverem dentro de aspas, sera mais facil usar as teclas Esc e A ou J no modo edicao, para eliminar 
os caracteres indesejados. 

Para limpar todos os caracteres a partir da posicdo do cursor até o fim da linha mostrada, 
aciona-se Esc seguido de E. Isso tem o mesmo efeito de se acionar a barra de espaco repetidamente 
até o fim da linha, porém o cursor nado se move. Os caracteres da proxima linha nao sao limpos, 
mesmo se fizerem parte da mesma linha de programa. Por exemplo, se for acionado Esc e E tendo- 
se O cursor posicionado como abaixo: 


{O00 PRINT “QUEM NUNCDARYT COMELU MELADO, Qj 
ANDO COME SE LAMBUZA’ 
resulta em: 


{OO PRINT “QUEM NUNCA 


ANDO COME SE LAMBUZA” 


Cuidado! Se o RETURN for acionado agora, a linha 100 ficara terminada exatamente onde esta 
o cursor. Use a tecla > para copiar o resto da linha. 

Pode-se também limpar todo o texto da posicdo do cursor até o fim da tela. Para isso, deve-se 
acionar Esc e F. 


inserindo Caracteres 


Inserir caracteres numa linha é simples. Pode parecer confuso de inicio porque o resultado final 
nao é aparente. O Apple |! nado pode abrir espaco entre caracteres para gerar area de insercao. 
A Figura 3.3 mostra como o Apple || permite insercao de letras. Insere-se o texto sobre a linha 
com a ajuda dos movimentos do cursor (Esc etc.). O que se deve lembrar é que o que esta mostra- 
do na tela nao é uma réplica do que existe na memoria do computador. 

Temos aqui um exemplo de edi¢do que ilustra a inser¢do de caracteres. O exemplo usa o 
Integer BASIC (>) porém opera corretamente também no Applesoft. Vejamos a seguinte linha de 
programa: 
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AUTO 
Oe tlh 


10 PRINT “VENDE-SE ESTE MOVEL” 





FIGURA 3.3. Insercdo de Caracteres 


> NEW 


Y10 PRINT "VENDE=SE ESTE MOVEL” 
rtd 


Para inserir a palavra AUTO, na frente da palavra movel, primeiro listemos o programa: 


PLES T 
4f} PRINT “VENDE-SE ESTE MOVEL” 
rtd 
Usando apenas as teclas de movimentacdo do cursor (Esc etc.), posiciona-se o cursor exatamente 
sobre o primeiro digito do numero da linha, como segue: 


*LIST 
P4170 PRINT “YVENDE*SE ESTE. MOVEL” 
) 


Usa-se agora a tecla > para copiar a primeira parte da linha, parando em M. 
LIST 
417) PRINT “VENDE-SE ESTE [EMIOVEL” 


) 


Aciona-se a tecla Esc seguida por D para mover o cursor uma linha para cima. (Se houver carac- 
teres do lado direito do cursor nessa linha, pode-se limpa-los com o acionamento das teclas Esc 
e E.) 


PLIST [ a 
40 PRINT “VENDE-SE ESTE MOVEL” 


Digita-se a palavra AUTO 


rLiIST AUTO 
10 PRINT “VENDE-SE ESTE MOVEL” 
> 


Usando apenas os movimentos do cursor, posiciona-se o cursor sobre a primeira letra do texto 
a ser inserido. Nao se deve usar a tecla < para voltar o cursor. Embora pareca que ela faz a mesma 
coisa que Esc-B e Esc-J, a tecla < realmente limpa os caracteres que passam; ela iria eliminar a 
insercao! 
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PLIST Lea JUS 
70 PRINT “VENDE=SE ESTE MOVEL” 


s 


Acione a tecla Esc seguida pela tecla C para retornar o cursor a linha de programa original. 


rLtST ALTO 
Af} PRINT "“VENDE<-SE ESTE EMJIOVEL” 
Finalmente use a tecla > para copiar o resto da linha. Entaéo acione RETURN. Mostre a nova linha 
com o comando LIST. 


PLIST AUTO 

410 PRINT “VENDE-SE ESTE MOVEL” 
PLIST TS 

10 PRINT “VENDE-SE ESTE AUTOMOVEL” 
os 


O Apéndice B contém uma tabela de referéncia para os comandos de edicao. 


REEXECUTANDO EM MODO IMEDIATO 


O fato de que tudo que aparece na tela do Apple I! esta vivo permite que se execute qualquer 
comando colocado em modo imediato, desde que ainda seja visivel na tela. Pode-se executar um 
comando em modo imediato da forma como esta, ou ainda pode-se edita-lo. 

Em ambos os casos, a primeira coisa a fazer é posicionar o cursor sobre o inicio da linha 
de modo imediato. Use as teclas Esc e A, B, C ou D alternativamente como mostrado acima (ou 
Esc seguida por |, J, K ou M se estiver com Autostart Monitor). Use entao a tecla > para copiar 
a instrucado de modo imediato. Pode-se fazer modificacdes na linha, usando as técnicas mostradas 
acima para trocar, retirar ou inserir caracteres na linha. 

Para ver como isso funciona, observemos o programa em modo imediato abaixo, que calcula 
0 espaco, em pés ciibicos, de uma area de 10 X 25 X 8 pés. 


»PRINT “ESPACQO = “S708 2588 
ESPACOQ = 2O0G 


Pode-se mudar facilmente este programa para calcular o espaco de ambientes de diferentes tama- 
nhos. Para mudar as dimensdes para 10 X 25 X 14, por exemplo, primeiro deve-se posicionar o 
cursor no inicio da linha de programa em modo imediato. (Alternadamente, acione Esc e D trés 
vezes). Acione e segure a tecla ~ acionando e mantendo a tecla REPT. O cursor ira para a frente 
ao longo da linha de programa. Solte ambas as teclas quando o cursor chegar ao digito 8. Se ele 
for passado ou ndo tiver chegado, devido a se ter soltado as teclas antes ou depois, pode-se mover 
o cursor para a frente ou para tras um caractere por vez com as teclas < e ~. Pode-se também 
mover o cursor do inicio até o 8 acionando a tecla > repetidamente varias vezes, ao invés de usar 
o REPT e > emconjunto. 
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Com o cursor posicionado sobre o 8, digite a nova dimensdo de 14 e acione RETURN. 


SPRINT “ESPACO = “SIDR T4 
ESPACO = 3500 


LINGUAGEM DE PROGRAMACAO 


Uma linguagem de programacdo é o meio de comunicacao pelo qual podemos falar com o compu- 
tador. Existem muitas linguagens diferentes de programacao. Algumas, como o BASIC, sao de 
aplicacado geral, outras sao orientadas para tornar a execucao de programas mais facil dentro de 
areas especificas, como area comercial, cientifica, graficos, manipulacdo de textos, calculos etc. 
As linguagens de programacdo sao tao diferentes quanto as linguagens faladas. Além do BASIC, 
outras linguagens de programacao comuns sao Pascal, C, FORTRAN, COBOL, APL, PL/M, PL/1 
e FORTH. 

Os computadores Apple || podem usar varias linguagens de programacdo, dentre elas o 
BASIC e o Pascal. Este livro se concentra no uso do BASIC com o Apple II. 

Nao importando qual a linguagem de programac¢ao, todo 0 comando deve ser dado seguindo 
um conjunto de normas bem definido. Estas regras, no conjunto sao chamadas de sintaxe. Cada 
linguagem diferente tem sua propria sintaxe. 

As linguagens de programacdao, como linguagens faladas, tem d/a/etos. Os dialetos sao varia- 
¢des menores da sintaxe. O Apple II tem dois dialetos do BASIC, o Integer BASIC e o Applesoft. 
Devido as diferencas entre os dois dialetos, um programa escrito para um dialeto pode nao rodar 
no outro. Além disso, um programa escrito para o Apple |! pode nado rodar em outro computador, 
mesmo que esse outro computador também execute o BASIC. Entretanto, aprendendo a progra- 
mar 0 computador Apple I! em BASIC, qualquer que seja o dialeto, faz com que nao se tenha 
grande dificuldade em se trabalhar com qualquer outro dialeto. 

Algumas regras sintaticas de linguagens de programacao sao Obvias. Os exemplos de adi¢ao 
e subtracdo no inicio deste capitulo sdo exemplos de sintaxe Obvia. Nao é necessdrio ser progra- 
mador para entendé-las. Porém outras regras de sintaxe sao arbitrdrias e sem sentido, a menos que 
se conheca a sintaxe. Nao se pode procurar racionalizar as regras de sintaxe; usualmente nao ha 
racionalidade. Por exemplo, por que usar * para representar multiplicag¢do? Normalmente se 
usaria o X para multiplicacdo. Porém o computador nao teria meios de diferenciar 0 X que repre- 
senta multiplicacao do que representa a letra X. Assim, mais recentemente todas as linguagens 
de programacdo tém optado pelo asterisco (*) para representar a multiplicagado. A divisdo é 
universalmente representada pelo simbolo /. N&@o existe razao real para esta op¢do; o sinal de 
divisdto (+) nao esta presente no teclado do computador, de forma que outros caracteres devem 
ser escolhidos. 


ELEMENTOS DE BASIC 


Muitas das regras basicas de sintaxe do BASIC se referem a comandos individuais. A sintaxe dos 
comandos BASIC distribuem-se separadamente pelos seus trés grupos: ntimeros de linhas, instru- 


PROGRAMANDO EM BASIC 55 


¢cOes ao computador e dados. Descreveremos cada uma a seu tempo. Existem ainda umas poucas 
regras que se referem ao programa como um todo, como a ordem dos comandos. Abordaremos 
essas regras nos pontos apropriados no decorrer deste capitulo. 


REPASSANDO A NUMERAGCAO DE LINHAS 


JA falamos sobre a numeracdo das linhas com alguma profundidade. Apds uma breve revisao, 
entraremos em mais detalhes. Em modo programado, toda a linha de programa em BASIC deve 
ter um Unico nimero de linha. Os nimeros de linhas determinam a seqUéncia das instrucdes 
dentro do programa; o comando com o menor nimero sera o primeiro do programa e o de maior 
numero sera o Ultimo. 

O Integer BASIC permite nimeros com de 1 a 5 digitos com numeros inteiros variando de 
0 a 32767. 

O Applesoft permite nimeros de 1 a 5 digitos com valores inteiros entre 0 e 63999. 


Nameros de Linha como Endereco 


Em esséncia, os nimeros de linha sao uma maneira de enderegar as linhas de programa. Este 6 um 
conceito importante, desde que todo o programa tem dois tipos de comandos: 


1. Comandos que criam ou modificam dados, e 


2. Comandos que controlam a sequéncia em que a operacdo é executada. 


A idéia de que a operacao especificada pelo programa deve ser executada numa sequéncia 
bem definida 6 um conceito bastante sinples. Normalmente, a execucao do programa inicia e 
continua sequencialmente, como ilustrado abaixo: 


Sy 


20 
S305, 
40 


tes 


Logo descobriremos que muitos programas contém seqléncias de execucao essencialmente nao- 
sequencial. Isso faz com que os numeros de linhas se tornem importantes, porque se pode usar o 
numero da linha para identificar uma troca na sequéncia de execucdo. Isso pode ser ilustrado 
como segue: 
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Inicio 10 
a 


a0 


ne GOTO 70 
50 
60 


70 
“80 
etc. 


ESPACOS EM BRANCO 


De forma geral, podem-se usar espacos extra em branco livremente para melhorar a legibilidade do 
programa. Porém, como cada espaco extra em branco ocupa espaco extra de memoria, o Apple I! 
coloca os espacos em branco nao necessdrios para fora da linha de programa quando ela é entrada 
(e aciona-se RETURN). Assim, quando se listam linhas de programa com o comando LIST, o 
Apple |! coloca espacos em branco nos lugares apropriados para aumentar a legibilidade, de acordo 
com determinacdes anteriores. Nao se deve esquecer que é possivel suprimir essa colocacao de 
espacos com o comando TEXT ou digitando POKE 33,33 antes de dar o comando LIST. Um 
POKE 33,40 faz a tela voltar ao original. 

Deve-se ter cuidado ao usar espacos extra dentro de aspas. Compare os dois comandos abai- 
xO, por exemplo: 


PRINT “COLOGUE OS DABDOS INICTALS* 
COLOQUE OS DADOS INICTALS 


PR INT “ COLOQUE OS DADOS T NICIAIS” 
COLOQUE OS DADOS T NIMIALS 


DADOS 


A principal atividade do computador é entrar, manipular e expelir dados. Por isso, a forma como a 
linguagem de programacdo manipula dados, sejam n&meros ou texto, € um parametro muito 
importante. Descreveremos agora os tipos de dados que se podem encontrar em programas no 
Apple II. 


Cordées (Strings) 


Um cordao é um caractere ou uma seqiiéncia de caracteres dentro de aspas. Usamos corddes com 
o comando PRINT para as mensagens que aparecem na tela. Aqui estao mais alguns exemplos de 
cord6es: 
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“DIGITE OS DADOS” 

“CONTA NUMERO 105.443-4” 

“PEDRO ALVARES CABRAL” 

“LARGO DA CONCORDIA” 

“SAO PAULO, 10 DE DEZEMBRO DE 1954” 


Com apenas algumas excecdes, um corddo pode conter qualquer caractere que se possa 
entrar via teclado usando o alfabeto normal e as teclas numéricas, com ou sem SHIFT ou CTRL. 
As excecdes sdo <, >, RETURN, Esc, CTRL-H, CTRL-M, CTRL-U e CTRL-X. Essas excecdes ou 
movem o cursor dentro da tela ou finalizam a entrada, ou ambos. 

Os corddes podem ter comprimento de O a 255 caracteres. Um cordao sem nenhum carac- 
tere é chamado cordao nulo. 

Existem alguns caracteres invisiveis que podem ser produzidos acionando certas combi- 
nacoes de teclas. Por exemplo, acionando-se CTRL e G simultaneamente, o computador sera o bip. 
Pode-se colocar essa combinacado dentro do corddo. Tente usa-la dentro de um comando PRINT. 


PE TN Y “"  Acione CTRL-G varias vezes entre as aspas 


Neste exemplo, pode-se ouvir o caractere embora nao se possa vé-lo. Existem outros caracteres 
que sdo invisiveis e inaudiveis. Tais caracteres sao usados para controlar funcdes da impressora, 
periféricos de comunicacdo e outros componentes que se podem conectar ao Apple II. 

O Apéndice | lista o conjunto completo de caracteres do Apple II e informa que teclas 
geram qual caractere. 

Em Applesoft existe uma maneira pela qual se pode incluir, dentro de um cordao, carac- 
teres que nédo podem ser gerados pelo acionamento de teclas. Isso é feito com a fun¢ao CHR$, 
descrita adiante no Capitulo 4. 


Nameros 


Existem dois tipos de nimeros que podem ser guardados dentro do Apple II: /nte/ros, que sao 
numeros sem parte decimal, e numeros reais (também chamados nimeros em ponto flutuante), 
que tém parte fracionaria. Como se pode suspeitar, o Integer BASIC so aceita numeros inteiros. 
O Applesoft aceita tanto inteiros como reais. 

Devem-se expressar todos os numeros com virgula. Por exemplo, deve-se usar 32000, e nado 
32.000. 


Inteiros 


Um inteiro 6 um ndmero que nao tem parte decimal ou ponto decimal. O numero pode ser nega- 
tivo (—) ou positivo (+). Um n&mero sem sinal é tratado como positivo. Os nimeros inteiros 
devem ter valores na faixa entre —32767 e 32767. A seguir, alguns exemplos de inteiros: 


0 
1 
44 
32699 
~15 
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Nameros Reais 


Um numero real pode ser inteiro com parte fraciondria ou fracao. O numero pode ser negativo 
(—) ou positivo (+). Se nao tiver sinal assume-se como positivo. O menor (mais negativo) numero 
real é: 


—100000000000000000000000000000000000000 
€ O maior é: 
100000000000000000000000000000000000000 
Aqui estao aiguns exemplos de nimeros reais: 


5 
—15 
65000 
161 
0 
0.5 
0.0165432 
1.6 
24.0055 
—64.2 


Quando o valor fracionario de um ntmero chegar proximo de zero em cerca de 
-.000000000000000000000000000000000000003, sera convertido para zero. 


Notacao Cientifica 


Numeros reais muito grandes ou muito pequenos sao representados em Applesoft usando notacao 
cientifica. Qualquer nUmero que tenha mais de nove digitos a frente do ponto decimal sera expres- 
so em notacao cientifica. Qualquer numero fracionario mais proximo de zero que +1 sera expresso 
em notacao cientifica. 

Um numero em notacao cientifica tem a forma: 


numero Et+ee 


onde: 


numero é um inteiro, fracionario ou combinado, como ilustrado acima. A porcao numero contém 
os digitos numéricos significantes; e chama-se coeficiente. Se ndo aparece o ponto 
decimal assume-se que ele esta a direita do coeficiente. 
é sempre uma letra. Vem da palavra expoente. 
é o sinal opcional mais ou menos. 
ee 60 expoente com um ou dois digitos. O expoente indica a magnitude do numero, isto é, 
o numero de posicées a direita (expoente positivo) ou a esquerda (expoente negativo) 
de quanto o ponto decimal deve ser movido para fornecer a posicdo real do ponto 
decimal. 


m 


I+ 
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Aqui estao alguns exemplos de notac¢ao cientifica: 


Notacao Comum Notagao Cientifica 
1000000000 1E +09 
.000000001 1E —09 

200 2E + 02 
—123456789 —1.23456789E + 09 
—.0000123456789 —1.23456789E — 06 


Como se pode ver, a notacdo cientifica é uma forma conveniente de expressar numeros mui- 
to grandes ou muito pequenos. Os valores maximo e minimo dos numeros reais, que foram expres- 
sados como um punhado de zeros, podem também ser expressados como 1E+38 e 1E—38, res- 
pectivamente (muito mais compactos). De forma idéntica, o nimero mais proximo de zero é 
3E—38. 


Arredondamento 


Mencionamos anteriormente que os numeros reais podem ter até 9 digitos de precisdo. Para um 
numero maior que 1 ou menor que —1, significa que apenas os nove digitos mais 4 esquerda podem 
ser diferentes de zero. O Apple || arredonda e despreza qualquer digito excedente a nove. Temos 
alguns exemplos (veja que nimeros muito grandes sdo expressos em notacAo cientifica): 


JPRINT T2345478¢4 

1.234546/789E409 

e712 3456789123454 789 

“1.239456789E4+17 

274 SOO0D4TS 425 
~TSE0000476 

1790000000. 7558 

®NO000000.8 


Numeros fraciondarios (entre —1 e 1) estado sujeitos 4s mesmas limitagdes. Neste caso, entre- 
tanto, os nove digitos iniciam com o primeiro digito diferente de zero a direita do ponto decimal. 
Aqui estao alguns exemplos: 


“+ 


SPRINT ,V254547891 
» 1234546729 

Pre 2oen 4Oe Bot 234 
a] eee sig BE fe 4 
Poe DES HP ree) 


39 


cp. 
Sod 
7 
3, 


2G PBF 
=" od Lt ‘3% 3 tr 
4 Ww tes 56) F 3 ? E.4 


47 
ae 
4 4 
1? .oo0g00000700000007 588 
~UOOOODOSE--10 
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VARIAVEIS 


Até o presente, na discussdo de dados s6 consideramos valores constantes. As vezes é mais facil 
referenciar um item pelo seu nome ao invés de seu valor. E af entra o conceito de varidvel. 

Para aqueles que ja estudaram elementos de algebra, os conceitos de varidvel e nome de 
variavel sdo faceis de serem entendidos. Para os que nunca estudaram algebra, pode parecer que 
nomes de variaveis sao como nome que se dao a Caixas postais. Qualquer coisa colocada dentro da 
Caixa passa a ser o valor associado com o nome da caixa, até que alguma coisa nova seja colocada 
na caixa. Em ‘‘computés’’, dizemos que um valor foi armazenado na variavel. 





Nem sempre uma variavel se refere ao mesmo valor. Isso 6 muito importante — ela pode 
representar qualquer valor permitido. Pode-se alterar seu valor no curso do programa. O BASIC 
tem uma série de comandos para essa finalidade; eles serdo vistos mais tarde. 


Nomes de Varidveis em Integer BASIC 


Os nomes de variaveis em Integer BASIC podem ter de 1 a 100 caracteres. Essas sao as regras gerais 
para construir nomes de variaveis no Integer BASIC: 


OOOQ-::: 


Oj 
————_ ee 
[6 Ultimo caractere deve ser zero para variaveis tipo cordao 


Segundo, terceiro, quarto etc caracteres (opcional) podem 
ser letras ou numeros 


Primeiro caractere deve ser uma letra 


O Ultimo caractere do nome da variavel diz ao BASIC que tipo de dado ela representa — cordao 
ou numérico. 

As varidveis cordao referenciam uma sequéncia de caracteres com tamanho de 0 a 255. Os 
caracteres em branco também contam dentro do cordao. Antes de se usar uma variavel cordao, 
deve-se especificar seu tamanho maximo. Faz-se isso com o auxilio do comando DIM, que sera 
descrito mais tarde. Se isso nao for feito, sera emitida a mensagem de erro *** STR OVFL ERR. 
Seguem adiante alguns exemplos de nomes de variaveis, legais e ilegais: 
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Legais llegais 

A$ $ 

NOMEADO$ 9$ 

PARTE1$ NOME.DADO$ 
RESPOSTA$ 

X8$ 


Os valores numéricos no Integer BASIC devem ter valores contidos entre —32767 e +32767. 
Se esses limites forem ultrapassados, é dada a mensagem de erro *** > 32767 ERR. Abaixo se- 
guem alguns exemplos de valores numéricos legais e ilegais: 


Legais llegais 

A APLICACAO’ BASE 
CODIGOA 3X4Z 

xO STOTAL 


Nomes de Variaveis em Applesoft 


Um nome de variadvel pode ter um, dois ou trés caracteres no Applesoft. Aplicam-se as seguintes 
regras: 


i O ultimo caractere da o tipo de variavel: 


$ para varidvel cordao 
% para valor inteiro 
qualquer outro caractere indica variavel real 


O segundo caractere (opcional) pode ser qualquer 
letra ou nadmero 


Primeiro caractere deve ser letra 


O ultimo caractere diz ao Applesoft que tipo de dado a variavel representa. 

Uma varidvel cordao em Applesoft pode guardar um valor de tamanho entre 0 e 255 carac- 
teres. Nao se especifica o tamanho do cordao como no Integer BASIC; O Applesoft nao necessita 
disso. Aqui estado alguns exemplos de nomes de variaveis, legais e ilegais: 


Legais Ilegais 
A$ 0? 
MN$ M!$ 


F6$ 77$ 
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Varidveis inteiras referenciam nimeros inteiros entre —32767 e 32767. Se esse limite for 
excedido, 6 dada a mensagem ?ILLEGAL QUANTITY ERROR. Se for tentado armazenar um 
valor real numa variavel inteira, o Applesoft convertera o real para inteiro antes. Vamos ver as 
regras de conversdo rapidamente. Aqui estado alguns exemplos de varidveis inteiras legais e ilegais 
do Applesoft: 


Legais llegais 
A% A$% 
B% 31% 
A1% 3D% 
X4% 


Varidveis reais referenciam valores numéricos restritos na faixa de —10°* a +10°°, embora 
se possa trabalhar com valores de até 1.7 X 10°® (+) sob certas circunstancias. Se for tentado 
(numa variavel real) guardar um nimero maior, sera dada a mensagem 7OVERFLOW ERROR. 

Quando o valor de uma variavel real chega mais proxima de zero do que +2.9388 X 107° 
o Applesoft converte a zero. 

Lembre-se: as variaveis reais podem ter valores inteiros, desde que o inteiro é uma real com 
a parte fracionaria igual a zero. Aqui vado alguns exemplos de variaveis reais legais e ilegais: 


Legais Ilegais 
A 0 

B 7B 

Al A# 
AA 

25 


Nomes Grandes de Varidveis em Applesoft 


Os nomes de varidveis podem ter mais de dois caracteres alfanuméricos (mais o % ou $ para inteiros 
e cordées), mas apenas os dois primeiros caracteres sdo considerados no Applesoft. Assim, PRECO1 
e PRECO2 sao o mesmo nome, porque ambos iniciam com PR. No entanto, PRECO1 e PRECO1% 
sao diferentes, porque tém diferentes tipos de sufixo. 

O Applesoft permite nomes de variaveis de até 255 caracteres. 

Aqui estado alguns exemplos de nomes de variadveis com mais de dois caracteres: 


Legais Ilegais 

CONTADOR% ITEM#% 
BALANCOANUAL 2ATABELA 

NOME$ ENDERECO.COMERCIAL% 


Tenha os seguintes pontos em mente para uso de nomes de varidveis com mais de dois carac- 
teres: 
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1. Apenas os primeiros dois caracteres e o sufixo do tipo da varidvel (% ou $) sao signifi- 
cativos. Nao se deve usar nomes com extensdes do tipo CONTA1% e CONTA2%; eles 
referenciam a mesma variavel: CO%. 


2. Caracteres adicionais precisam espaco extra de memoria, que podem ser necessarios para 
Os programas maiores. Porém a vantagem de se usar nomes de variaveis maiores é que eles 
tornam o programa mais facil de ser lido. CODITEM, por exemplo, tem mais significado 
do que CO, para o nome da varidvel que fornece o codigo do item num programa de con- 
trole de estoque. 


Palavras Reservadas 


Todas as palavras que definem operacdes de comandos BASIC sao chamadas pa/avras reservadas. O 
Apéndice F fornece todas as palavras reservadas tanto do Integer BASIC quanto do Applesoft. 
Muitas dessas palavras reservadas ja foram vistas neste capitulo, e outras serao descritas em outras 
partes do livro. 

Na execucao de um programa BASIC, o Apple |! varre todos os comandos BASIC, procu- 
rando corddes que se constituam em palavras reservadas. A Unica excecdo sao os cordoes de texto 
entre aspas. Pode causar problema a insercdo de uma palavra reservada como nome de variavel. 
O Apple |! nao é esperto o suficiente para perceber um nome de varidvel apenas por sua localiza¢ao 
no comando BASIC. Assim, deve-se ter muito cuidado para nao incluir palavras reservadas como 
nomes de varidveis; isso 6 especialmente importante com as palavras reservadas menores que podem 
facilmente ser tomadas como nomes de variaveis. 


ARRANJOS 


Arranjo 6 apenas uma forma sistematica de se dar nomes a uma lista grande de variaveis. Eles sao 
usados frequentemente em muitos tipos de programas de computador. Se for dificil entender o 
que significa arranjo, ou como usa-lo, leia esta secao; a informacdo que segue é muito importante 
em seu desenvolvimento para programacao. 

Conceitualmente, um arranjo 6 uma coisa muito simples. Quando se tem dois ou mais itens, 
ao invés de se dar um nome a cada variavel, da-se um nome sO ao Conjunto inteiro. Esse conjunto 
é chamado arranjo, e seu nome é 0 nome do arranjo. Cada um dos elementos componentes é um 
elemento do arranjo. Os elementos do arranjo sio numerados. Seleciona-se um elemento usando 
seu numero de posicdo, que se chama /ndice. 

Arranjos séo uma forma compacta de descrever um amontoado de variaveis relacionadas. 
Veja, por exemplo, uma tabela de 200 nimeros. Pense como seria penoso associar cada um dos ele- 
mentos da tabela com um nome de variavel. E muito mais simples dar-se um Unico nome 4 tabela 
inteira e identificar cada um dos numeros pela sua posi¢do. Isso é precisamente o que faz o arranjo. 

Como exemplo de aplicacéo do arranjo, pensemos num hotel com dez quartos com a neces- 
sidade de saber quem esta em qual quarto. 


Q1$ Q2$ Q3$ Q4$ Q5$ Q6$ Q7$ as$ ag$ 


Q10$ 


64 APPLE II 


Ou se pode considerar a lista de clientes do hotel como um arranjo. 


PEDRO | MARIA | JOSE || pauto LUIZ |SERGIO|MARCIA| CELSO a 


Q$(1) Q$(2) = Q$(3) = QSl4) = QS5) = QSI7) = QS(7) ~=—s Q(B) ~=— QSI9)_ ~—-Q$(10) 


Nesse exemplo, R$ é o nome do arranjo. Ele tem dez elementos; cada elemento é 0 nome do ocu- 
pante de cada quarto. O /ndice (entre parénteses) segue cada nome da variavel. Assim um dado 
especifico (por exemplo, o ocupante do quarto 1) é identificado pelo nome da variavel e um indi- 
ce. O ocupante do terceiro quarto é o valor de O$(3), que é JOSE. 

O exemplo de arranjo acima usa arranjo de cord6des porque eles sao mais intuitivos para se 
entender. Porém, o Integer BASIC so permite arranjos numéricos. 

Os arranjos no Applesoft podem representar variaveis inteiras, reais ou cord6es; no entanto, 
um arranjo simples sO pode representar um tipo de dado. Em outras palavras, uma variavel simples 
nao pode misturar numeros inteiros e reais, A excecdao de que uma varidvel real pode conter um 
numero inteiro (nado vice-versa). Cada tipo de arranjo usa uma quantidade diferente de espaco de 
memoOria; veja o Apéndice G para detalhes. 


Dimensdes de Arranjos 


Deve-se especificar o numero de elementos de um arranjo antes de usd-lo no Integer BASIC. Faz-se 
isso com o Gomando DIM. Os comandos DIM serao descritos adiante neste capitulo. 

O Applesoft permite usar arranjos com até 10 elementos sem ter que defini-los antes. 

Os arranjos do Applesoft podem ter mais de uma dimensao, o que quer dizer que existirdo 
mais de um indice para selecionar cada elemento. Um arranjo com uma so dimensdo é equivalente 
a uma tabela com apenas uma linha de elementos. O /ndice identifica o elemento dentro da linha. 
Um arranjo com duas dimensdes 6 como uma tabela de nimeros, montados em forma de linhas e 
colunas; um indice identifica a linha e outro a coluna. Pode-se visualizar um arranjo de trés dimen- 
s6es como um cubo de nuimeros, ou mesmo uma pilha de tabelas. Quatro ou mais dimensdes no 
arranjo é mais dificil de visualizar porém, sob o ponto de vista matematico, nado é mais complicado 
que um arranjo simples de uma so dimensdo. 

Pode-se criar um exemplo de arranjo de duas dimensGes por extensdo do anterior. Conside- 
remos um hotel de oito andares, com dez quartos em cada andar. Existem quatro opcOes que se 
podem adotar para controlar os 80 possiveis clientes. Primeiro, cada quarto ter seu proprio nome 
. de varidvel. Segundo, o hotel pode ter um arranjo de 80 elementos. Terceiro, cada andar pode ter 
seu proprio arranjo de 10 elementos. Quarto, o hotel pode ter um arranjo de duas dimensGes. 
A opcao final pode ser vista como segue: 


PROGRAMANDO EM BASIC 65 


H$(6,1) H$(6,3) H$(6,5) 
H$I5,1) H$(5,3) H$(5,5) 


Como se pode ver, o primeiro indice do arranjo de duas dimensGdes indica o numero do andar e o 
segundo indice é o numero do quarto naquele andar. Assim, Q$(3,2) deve ser o nome do ocupante 
do segundo quarto no terceiro andar. 

Os arranjcs do Applesoft podem ter até 88 dimensGes. Nao existe limite especifico para o 
numero de elementos em cada dimensao. O tamanho da memoria disponivel limita o numero total 
de elementos, claro, desde que cada elemento necessita um certo espaco de memoria. 






















EXPRESSOES 


Na secao seguinte vamos explorar as formas pelas quais podem-se combinar os valores de variaveis 
e constantes usando expressdes. Jé usamos expresses para calcular o valor de problemas aritmé- 
ticos simples em modo imediato. Lembre-se do comando 

PRINT G74 


1H 
que diz ao Apple || para somar 4 e 6, e mostrar a soma. O comando 


PREMT 44-6 
(i 


diz ao Apple || para somar os valores de duas variaveis numéricas A e B, e mostrar a soma. 

O sinal mais (+) especifica adic¢éo. Em ‘‘computés”’ esse sinal 6 um operador. O sinal mais é 
um operador aritmético porque especifica adi¢ao, que é uma operac¢ao aritmética. 

Os operadores aritméticos sdo bastante simples de se entender; todos ja aprendemos a somar, 
subtrair, multiplicar e dividir quando criancas. Porém, existem outros tipos de operadores: opera- 
dores de cordao, operadores relacionais e operadores Booleanos. Eles também sao faceis de se 
entender, mas requerem um pouco mais de explica¢do por usarem notacao um pouco mais abstrata. 

Cada categoria de operadores define um tipo de expressdo. Existem expressOes aritméticas, 
expressOes de cordao, expressdes relacionais e expressOes Booleanas. 


Precedéncia de Operadores em Expressdes 


As expressOes podem provocar ocorréncia de mais de uma operacdo. Por exemplo, o comando: 
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PRINT Ate 10 
n 


chama adi¢ao e divisio numa mesma expressdo. Existe um esquema padrao para determinar em 
que ordem as express6es devem ser resolvidas. Vamos descrever essas regras de precedéncia para 
cada tipo de expressdo que inicia com concatenacao de cordoes, inteiros, reais, relacionais, Boolea- 
nos e expressdes mistas, nessa ordem. Primeiro vamos ver uma forma de evitar as regras de prece- 
déncia acima. 


Contornando as Regras de Precedéncia 


Pode-se trocar a ordem que o Apple II utiliza para resolver as expressGes através do uso de parén- 
teses. Qualquer operacdo dentro de parénteses é realizada primeiro. Quando mais de um conjunto 
de parénteses esta presente, o Apple I! calcula da esquerda para a direita. 

Quando um conjunto de parénteses esta envolvido por outro, diz-se que ele esta aninhado. 
Neste caso, o Apple I! calcula primeiro o mais interno e depois os subseqiientes. Os parénteses 
podem ser aninhados em qualquer quantidade. Pode-se usa-los livremente para tornar clara a ordem 
de precedéncia dos calculos na resolucdo de express6es. 

Aqui estao alguns exemplos de calculos aritméticos em modo imediato usando parénteses: 


"RINT (2410) %2 
& 


? 
. 


o hae 


PRINT (C2s70) 83434 > #40 
SQ 


PRINT ~€aeC3+6/4)) 
“hy 
7.2 G. 


Concatenacgao de Cordao 


Pode-se juntar corddes um no fim do outro para formar um cordao maior. Isso se chama conca- 
tenacao. Pode-se ver isso abaixo: 


CORDAO!1 + CORDAO2 + CORDAO3 


transforma-se em 


CORDAOQ!1 | CORDAO2 | CORDAO3 


Com a concatenacdo, pode-se obter corddes com até 255 caracteres de comprimento. 
O Integer BASIC nao possui operacdo de concatenacdo. Pode-se concatenar cordées no Inte- 
ger BASIC usando as técnicas mostradas no fim deste capitulo (mostrar agora seria prematuro). 
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O Applesoft usa o sinal mais (+) com operador de concatenacao. Aqui estao alguns exemplos 
de concatenacao no Applesoft: 


“LOCO” + “MOTIVA” torna-se “LOCOMOTIVA” 

“RELATORIO” + “ ” + “MENSAL” _ torna-se “RELATORIO MENSAL” 

“CONTA” + A$ torna-se “CONTA” seguido pelo valor de A$ 

A1$ + YA$ + C$(1) torna-se o valor de A1$ seguido pelo valor de YA$ 


seguido pelo valor de C$(1) 


Expressdes Inteiras 


ExpressGes inteiras sao expressdes aritméticas que envolvem apenas variaveis e constantes inteiras. 
Mostraremos as expressdes aritméticas que usam tanto valores inteiros quanto reais sob o titulo 
‘“‘Expressoes de Tipo Misto”’. 

Os operadores para expressdes inteiras séo adicdo (+), subtracao (—), multiplicagao ( * ), 
divisdo (/) e exponenciacdo (A). Pode-se também usar o sinal negativo (—) para indicar um valor 
numérico negativo. As operacdes sdo executadas na seguinte ordem: primeiro o negativo (—), 
depois a exponenciacao, a multiplicagdo e a divisdo, e por Ultimo a adicao e a subtracao. As ope- 
racdes com igual precedéncia s4o executadas na ordem da esquerda para a direita. 

Aqui estao alguns exemplos de express6es inteiras no Integer BASIC: 


100 — 30 * 2 resulta em 40 

—9A2 resulta em 81 

A/B*C resulta no valor de A dividido pelo valor de B, e no valor inteiro da 
divisao multiplicado pelo valor de C 

D+X*3 resulta em 3 vezes o valor de X somado ao valor de D 

5/2*2 resulta em 4 (o quociente de 5/2 é convertido para o inteiro 2) 


Aqui estado alguns exemplos de express6es inteiras no Applesoft: 


—120/2 + 100 resulta em 40 
2N3*2 resulta em 16 


N1% *N2%/N3% resulta no valor de N1% vezes o valor de N2% e no produto dividido 
pelo valor de N3% 


AA%/AB%/AC% resulta no valor de AA% dividido pelo valor de AB% e no quociente 
dividido pelo valor de AC% 


5/2*2 resulta em 5 (o quociente de 5/2 nao é convertido para inteiro) 


O Integer BASIC tem um operador a mais que pode ser usado em expresses inteiras. Ele 
retorna o resto de uma operacdo de divisdo em que o dividendo nao é divisivel pelo divisor. 
O operador é o MOD, e tem a mesma precedéncia que a multiplicacado e a divisdo. Aqui estado 
alguns exemplos do MOD: 
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4MOD3 resulta em 
3*5MOD 4 resulta em 
(41+2)/25MODA resulta no 
3MOD 4 resulta em 


Expressoes Reais 


1 
3 


APPLE II 


resto da divisdo obtida dividindo 18 pelo valor de A 


3 


O Applesoft tem outro tipo de expressGes aritméticas; ele fornece numeros reais. Os seus opera- 
dores sdo oS mesmos que os das operacoes inteiras do Applesoft: adicao (+), subtragado (—), multi- 
plicagdo ( * ), divisdo (/), exponenciagdo ( A) e negativo (—). A precedéncia dos operadores tam- 
bém é a mesma: primeiro negativo, depois exponencia¢do, multiplicacdo e divisao, e por fim adi¢ao 
e subtracao. Aqui estado alguns exemplos de express6es reais: 


87.5 —4.25*2 resulta em 
1.5 A(3/2/2) resulta em 
AL*(PL —3.1*CB) resulta no 


7.5*2/5 resulta em 


Expressdes Relacionais 


79 
1.35540301 


valor de AL vezes o resultado da subtracao do produto de 
3.1 vezes o valor de CB do valor de PL 


Os operadores relacionais permitem que se compare dois valores para ver qual a rela¢ao entre um e 
outro. Pode-se comparar dois valores para ver se o primeiro é maior que, menor que, igual, dife- 
rente, maior ou igual ou menor ou igual que o segundo valor. Os valores comparados podem ser 
constantes, varidveis ou qualquer tipo de expressdes. (Existem algumas restri¢des no Integer 


TABELA 3.1. Operadores Relacionais. 






Operadores do 
Integer BASIC 












* Ndo permitido com corddes em Integer BASIC. 





Operadores 
Applesoft 





Operacao 


menor que” 
maior que* 


igual a 






<> 60 > X% 
>=ou=> 
<=ou=-< 


diferente 





maior ou igual a* 





menor ou igual a™ 
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BASIC.) Se o valor de um lado do operador relacional 6 um cordao, o valor do outro lado tam- 
bém deve ser tipo corddo. Fora isso, pode-se comparar um tipo de valor com outro usando opera- 
dores relacionais. 

Se a relacao é verdadeira, a expressdo relacional tem o valor numérico de 1. Se ela é falsa a 
expressao relacional tem o valor numérico 0. 

Os operadores relacionais para o Integer BASIC e o Applesoft sdo os mesmos, com excecoes, 
como mostrado na Tabela 3.1. 

Todos os operadores relacionais tem a mesma precedéncia; eles sdo calculados da esquerda 
para a direita. 

Aqui estado alguns exemplos de express6es relacionais: 


1=5-4 resulta em 1 (verdadeira) 

14> 66 resulta em O (falsa) 

15 >= 15 resulta em 1 (verdadeira) 

“BA” > “AA” resulta em O (falsa) 

“ABILIO’ <“ANDRE” resulta em 1 (verdadeira) 

(A = B) = (A$ > B$) depende do valor das varidveis. Se o valor de A é igual ao valor 


de B e o valor de A$ é maior que o valor de B$, 
entao o valor dessa expressdo resulta em 1 (verdadeira) 


O conceito que orienta os operadores relacionais é facil de ser entendido. Os valores 0 e 1 
que o BASIC determina arbitrariamente como condicdao falsa e verdadeira podem ser usados em 
expressOes inteiras e reais. Isso nao é tao facil de se entender, porque é arbitrario. Por exemplo, 
qual o significado da expressdo (1=1)*4? Fora de um programa em BASIC esta expressdao nao 
teria O menor sentido; mas dentro do BASIC é o mesmo que 1*4, o que resulta em 4. Pode-se 
incluir expressdes relacionais dentro de outras expressdes no BASIC. Aqui estado alguns exemplos: 


25 + (14> 66) é 0 mesmo que 25 +0 
(A+ (1=5 —4))* (15 >=15) 6&0 mesmo que (A + 1) * (1) 


Comparacgao de Cordédes 


Vamos aqui considerar quais as regras que o Apple || usa para comparar cordées de texto. Existem 
duas consideracdes. A primeira é sobre o tamanho do cordao. Corddes de diferentes tamanhos 
(lembre-se que os espacos em branco ocupam espacos no corddo) nao sao iguais. Se um cordao 
pequeno é idéntico 4 primeira parte de um cordao maior, 0 cordao maior é tomado como o maior 
dos dois (isso s6 se aplica ao Applesoft). A segunda consideracdo é sobre corddes que tem o mesmo 
numero de caracteres, na mesma ordem. No Integer BASIC, s6 se podem comparar dois corddes 
com os operadores = e # ou <>. Os cordées sAo comparados com um caractere por vez, iniciando 
com o colocado mais a esquerda — o primeiro caractere de um corddo com o primeiro caractere 
do outro, 0 segundo com o outro, o terceiro com o outro e assim por diante até que os dois 
cord6es terminem ou ocorra uma diferenca. 

O Applesoft compara a ordem relativa dos caracteres um a um. Para propdésitos de compa- 
racao, as letras do alfabeto tem a ordem A<B,B<C,C<D,1<2,2 <3 etc. Outros caracteres 
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que aparecem no cordéo, como +, —, $ etc. sdo colocados arbitrariamente na ordem mostrada 
no Apéndice |. 


Expressoes Booleanas 


Os operadores Booleanos dao aos programas a habilidade de fazer decisdes idgicas. Por isso eles sao 
chamados também de operadores /égicos. Existem quatro operadores légicos padrdes: AND, OR, 
OR exclusivo e NOT. O BASIC do Apple |! suporta trés desses operadores: AND, OR e NOT. 

Se existe dificuldade para se entender o conceito dos operadores Booleanos, uma analogia 
com compras em supermercado serve para ilustrar como sao eles. Suponhamos que estamos num 
supermercado para comprar doces em companhia de duas criancas. O operador AND diz que vocé 
vai comprar o doce se as duas criancas quiserem. O operador OR diz que vamos comprar o doce 
se uma das criancas quiser. O operador NOT é o da contrariedade. Se a crianca A insiste em dis- 
cordar da crianca B, sua decisao é o NOT dela. 

Os computadores nao operam com analogia; eles trabalham com numeros. Por isso a ldgica 
Booleana reduz os valores das decisdes a 1 ou O {(verdadeiro ou falso). Como os operadores Boolea- 
nos trabalham com uns e zeros, eles sdo frequentemente usados em express6es relacionais (lembre- 
se que as expresses relacionais sempre resultam em uns e zeros). Os operadores Booleanos podem 
trabalhar com outros tipos de operandos, como veremos rapidamente na proxima secao. 

A Tabela 3.2 sumariza a forma pela qual as expressOes Booleanas sao calculadas. Essa tabela 
é referenciada como tabe/a verdade. Os operadores Booleanos tém igual precedéncia. Se aparece 
mais de um operador Booleano na mesma expressdo, o calculo é feito da esquerda para a direita. 
Aqui estado alguns exemplos de operadores Booleanos: 


NOT ((3 + 4) > = 6) resulta em O (falso) 
(“AA” = “AB”) OR ((8*2) =4A2 — resulta em 1 (verdadeiro) 


NOT (“APPLE” = “ORANGE”) 
AND (A$=B$) _ resulta em 1 (verdadeiro) se A$ e BS forem iguais e 
O (falso), se nao forem. 


TABELA 3.2. Tabela Verdade Booleana. 


A operacado AND resulta em 1 se ambos os valores forem 1. 


1 AND 1 = 1 1 ANDO =0 
0 AND 1=0 0 ANDO =0 


A operacdo OR resulta em 1 se algum deles for 1. 


1OR1=1 1OR0=1 
0OOR1=1 0ORO=0 


A operacdo NOT complementa logicamente cada valor. 
NOT 1=0 
NOT 0 = 1 
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Expressoes do Tipo Misto 


Muitas vezes as expressOes envolvem valores de mais de um tipo. Isso é especialmente frequente 
no Applesoft, que trabalha com numeros inteiros e reais. Ja foi colocada a idéia de expresses do 
tipo misto quando discutimos as expressGes relacionais e Booleanas. Pode-se misturar os tipos de 
expressOes de forma livre, 4 excecdo de que os corddes ndo podem fazer parte de expressdes 
inteiras, reais ou Booleanas. Os corddes sO podem fazer parte de expressdes deles mesmos e das 
relacionais. Aqui estado alguns exemplos de expressdes do tipo misto: 


Legais Ilegais 

3.1416 *(RA2) 1600 + “AVENIDA SAO JOAO” 
A% >= B/3 ST$ << A% 

43 AND 137 A$ AND B$ 

1OR 4E + 10 NOT (A$) = B$ 

(A$ = B$) AND —6.25 NOT (A=B) OR C$ 


TABELA 3.3. Operadores. 









Operador em 
Applesoft 


Operador em 
Integer BASIC 





Precedéncia Significado 


Parénteses da a ordem 
de calculo 


E xponenciacao 


9 
(maior) 


~_— 
— 

















Negacdo 
Operadores Mu Iti plicagao 
Aritméticos Divisdo 

Resto da divisio”** 

Adicao 


Subtracao 





Igual 











Diferente 
Operadores Menor que 
Relacionais Maior que 





Menor ou igual a 
Maior ou igual a 


[-v+|eseees 


NOT NOT Complemento ldgico 
Operadores AND AND E ldgico 
Ldégicos OR OR OU ldgico 












(menor) 


** Apenas no Integer BASIC. 
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O Apple II tem varias coisas a resolver quando esta operando com operadores misturados. 
A primeira preocupacdo 6 com a precedéncia dos operadores. A Tabela 3.3 mostra os operadores 
de todos os tipos na ordem de precedéncia, da maior para a menor. Ela indica que tudo que esti- 
ver entre parénteses 6 calculado primeiro. Se existir mais de um nivel de parénteses, o Apple II 
calcula o mais interno primeiro, depois o seguinte etc. (Relembre o conceito de parénteses aninha- 
dos.) Depois, sao calculadas as expressGes aritméticas. Finalmente as expressdes relacionais e as 
expressoes Booleanas. 

Como foi visto antes, as expressGes relacionais devolvem o valor 1 ou O dependendo se a 
relacdo testada for verdadeira ou falsa. Assim, uma expressdo relacional pode ser parte de uma 
expressao inteira ou real. 

Pode-se também misturar tipos em expressdes Booleanas. Tudo, numa expressdo Booleana, é 
convertido em 1 e O, antes que a operacdao seja executada. Os valores numéricos sao convertidos de 
acordo com a seguinte regra: se o valor é O, ele fica 0; se é diferente de 0 é convertido para 1. 

O BASIC nao pode, automaticamente, converter cord6es para valores numéricos, de forma 
que os cordGes sao ilegais em expressdes inteiras, reais e Booleanas, exceto como parte de expres- 
sao relacional. 

No Applesoft tanto valores inteiros quanto reais podem estar presentes em expressOes reais 
inteiras e Booleanas. 

Quando valores inteiros ocorrem em expressGes reais, eles sao convertidos temporariamente 
para real para o cdlculo da expressdo. O resultado final de tal expressao pode ser tanto um inteiro 
quanto um real, dependendo do contexto em que a expressao ocorra. O Applesoft converte o valor 
automaticamente de forma apropriada. 

Os valores reais sao convertidos para inteiros eliminando a parte fracionaria e usando o me- 
nor numero inteiro seguinte. Isso 6 chamado truncar. Por exemplo: 


1.1. torna-se 1 
1.9  torna-se 1 
—1.1 torna-se —2 
—1.9 torna-se -—2 


COMANDOS DO BASIC 


Agora estamos prontos para descrever a parte do BASIC que especifica a operac¢ao que o comando 
executara. Especificam-se essas operacdes com instrucdes BASIC. E uma pratica comum se usar os 
termos comando e determinacao de forma idéntica e ambigua. Rigorosamente, um comando é uma 
instrucao executavel em modo imediato. A mesma instru¢ao dentro do programa é uma determi- 
nacao. 

Cada instrucdo executa uma tarefa especifica. Este capitulo introduz conceitos de progra- 
macaéo, mostrando a forma como as determina¢des sao usadas. Nao as mostraremos em detalhes 
aqui. A descricao completa das determinacdes se encontra no Capitulo 8 que pode ser consultado 
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para se ter melhor idéia de como operam. Este capitulo apenas conduz ao entendimento de parte 
da capacidade das determinacoes. 

Uma ultima observagdo antes de comecarmos. Embora este capitulo introduza conceitos de 
programacao, ele nado divide programacdo em partes. Se for necessario ter mais conhecimentos 
sobre programacao propriamente dita, consulte a lista de livros de iniciagdo constantes no Apén- 
dice K. 


COMENTARIOS 


E interessante que toda a abordagem sobre as declaracdes do BASIC inicie com a descricado da 
Unica declaragd4o BASIC que o computador ignora: o comentario. Se os primeiros trés caracteres 
da declaragdo sfo REM, 0 computador ignora completamente a declaracdo. Entao, por que existe 
tal declarag¢do? A resposta é que o comentario torna o programa facil de ser lido. 

Se se escreve um programa pequeno com cinco ou dez declaracdes, provavelmente nao 
existem maiores problemas quando, apds algum tempo, se deseja lembrar o que aquele programa 
faz e como — a menos que o tempo decorrido seja muito grande. Porém se o programa escrito tem 
100 ou 200 declaracdes, é muito provavel que se esqueca algo muito importante sobre ele ja na 
proxima vez que se va usda-lo. Apos escrever algumas dizias de programas, é certo que nao nos 
lembramos de cada um deles em detalhes. A solucao para este problema de documentar programas 
é a insercdo de comentarios. 

Os bons programadores tém seus programas repletos de comentarios. Em todos os exemplos 
de programas deste capitulo incluiremos comentarios para informar o que esta acontecendo, para 
estimular a todos que os utilizem também. 

Os comentarios tém ndmero de linha, como qualquer outra declaracdo. O numero de linha 
da declaracao de comentario pode ser usado como se usa qualquer outro numero de linha. 


DECLARACAO DE ATRIBUICAO 


Declaracdes de atribuicdes fazem associar valores a varidveis. Encontram-se declaracdes de atri- 
buigdes frequentemente, em todos os tipos de programas BASIC. 


eM REM TMICIALIZA A VARTAVEL xX 

TOO LET eB 

Na declaracdo 100, a variavel X é atribuido o valor 3; esta mesma declaracdo pode ser reescrita: 
{OQ Xso 

A palavra LET é opcional; normalmente é omitida. 

Aqui esta uma declaracao de atribuicdo de variavel do tipo cordao: 

ei Age" DOCE YTbaA” 

Atribui-se a variavel corddo A$ as duas palavras ‘“‘DOCE VIDA”. 


Seguem trés declaracdes de atribuicao que atribuem valores a variavel tipo arranjo R$(), que 
foi encontrada antes quando descreviamos os arranjos: 
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200 REM R$C> E UMA LISTA BE CLIENTES ODO HOTEL 
210 RéC4)9="J0ONES" 

ee) REC 2)="SMITH" 

230 R$¢C2)="DOE” 


Lembre-se de que podemos colocar mais de uma declaracao por linha; assim as trés decla- 
racdes de R$ podem ser colocadas numa Unica linha, como segue: 


200 REM RC) E UMA LISTA DE CLIENTES 00 HOTEL 
210 RSC1) =" ONES" RE C2) "SMITH" PRE ¢ 3) = "DOE" 
Lembre-se de que cada declaracao na mesma linha deve ser separada da anterior por dois pontos ( : ). 
As declaracdes de atribuig¢do podem incluir quaisquer operadores aritméticos ou ldgicos ja 
descritos neste capitulo. Aqui estao alguns exemplos: 
OM REM ESTA E UMA FORMA BOBA DE ATRELTBUTR UM YALOR 
JOO VUsx334+7 79 


A declaracao acima atribui o valor 33.77777778 para a variavel real V; 6 equivalente a trés 
declaracoes: 


OO REM X E Y SERAQO USADAS MAIS TARDE 
FOO X7 
Tt YSy7 
{20 VYVesorx/y 


que poderiam ser escritas numa so linha: 
{OO Xs/7 a Pe Ose Goax /yY 
Aqui esta uma declaracdo de atribuicdo que executa operacdes Booleanas descritas anteriormente: 
of) REM EXEMPLOS DESCRTITOS ANTERLORMENTE 


FOO A=NOTC C344) >26) 
F110 Bec"AA*="AB") OR CCB ye C42) ) 


O exemplo seguinte mostra como uma variavel tipo cordao pode ter um valor atribufdo usan- 
do a concatenacao do Applesoft: 


SO REM R€¢46) TERA O YALOR SEY JOA 
410 SES = “Sell * 
{20 DONA = “DONA* 
130 NS = "ORO" 
eQOO RFCS) = SEUS + NS 


Declaragoes READ e DATA 


Quando muitas variaveis precisam de atribui¢do num programa do Applesoft, pode-se usar as 
declaragdes READ e DATA ao invés do tipo de declarac¢ao de atribui¢ao anterior. Veja os exem- 
plos seguintes: 


PROGRAMANDO EM BASIC 75 


"2 REM INICIALIZA VARTAVETS 00 FROGR AMA 
TW DATA 10,20,-4, 300 
el} READ ABLE. D 
A declaracdo da linha 10 especifica os valores numéricos das variaveis. Esses quatro valores sao 
atribuidos para as varidveis pela declaracdo da linha 20. Depois que as dec!aracdes das linhas 10 e 
20 forem executadas, A= 10, B=20, C=—4 e D=300. 

Se existe mais de uma declaracdo DATA no programa, pode-se visualiza-las como uma coluna 
de valores. Por exemplo, uma declaracdéo DATA que contém uma lista de 10 valores constitui uma 
coluna de 10 entradas. Duas declaracdes DATA, cada uma contendo uma relacao de 5 elementos, 
constitui exatamente a mesma coluna. Isso pode ser ilustrado como segue: 


1O0DATA 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 t 


Entrada da primeira on 10 
20 


30 
| 40 

50 

60 

70 

80 

90 
100 /+— Entrada da Ultima coluna 


10DATA 10,20,30,40,50 } 
20DATA 60, 70, 80, 90, 100 } 


A primeira declaracaéo READ no programa inicia na primeira coluna e pega os valores seqiien- 
cialmente, atribuindo-os as varidveis que aparecem na declaracdo READ. A segunda (e seguintes) 
declarag¢déo READ pega valores da coluna, iniciando no ponto onde o READ anterior parou. Isso 
pode ser ilustrado como segue: 


10DATA 10, 20, 30, 40, 50, 60, 70, 80, 90, 100} 


A=10 10 
: eB 20. 20 
220 READA.B.C [=e ae 
C=40. "150 
D =50 60 
70 
: 80 
340 READ C, D A=60 106 
; E=70 
_ = 80 
G=90 
° es a 
490 READA.E.F.G 
500 READ B B= 100 
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A coluna DATA pode conter tanto valor numérico como cordao. Quando se associa um 
valor a uma variadvel usando a declarag¢do READ, cada valor deve ser do mesmo tipo (cordao ou 
numérico) da variavel a qual sera atribuido. 


Declaracao RESTORE 


Pode-se voltar o ponteiro ao inicio da coluna DATA executando a declaracgdo RESTORE no 
Applesoft. Aqui esta um exemplo de como o RESTORE opera: 


10DATA 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 t 


A=10 10 
220 READ A,B,C C =30 30 
* ee, 
340 READC,D 


350 RESTORE 





e a i 
490 READ A,E,F,G 
500 READ B—________- B = 50 


Limpando Varidveis 


Tanto o Integer BASIC quanto o Applesoft permitem colocar elementos numéricos e elementos 
de arranjos a zero, e toda a varidvel cordao e elementos do arranjo nulos, tudo de uma so vez. 

O comando CLR faz isso no Integer BASIC. Ele s6 pode ser usado em modo imediato. Aqui 
esta um exemplo: 


>Xa37 
>PRINT X 


37 


rCLR 
>PRINT xX 
{) 


A declaracéo CLEAR faz isso no Applesoft. Ela também opera no DATA como faz o RESTORE. 
Aqui esta um exemplo: 


Ti REM INICTALIZA VARTAVETE 
W2Q MG7 

J30 Age" CAVALLO GE AOS 

J40 PRINT 4 

TSO CLEAR 

460 PRINT & 

ot RELI 

CAVYALG DE ACO 

0 
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DECLARANDO O TAMANHO DE ARRANJOS E CORDOES 


Se for necessdrio usar arranjos e corddes no seu programa, devem ser declarados os tamanhos 
maximos (ou dimensdes) numa declaracdo ou declaracdes DIM (chamada declaracdo de dimensio- 
namento) no inicio do programa. Uma declaracao de dimensionamento pode dar a dimensdo de 
qualquer numero de arranjos e corddes desde que caiba numa linha padrao de programa. 

Em Integer BASIC, isso é feito fornecendo o nome do arranjo ou da variavel cordao e a se- 
guir o valor maximo, entre parénteses. SAo permitidos arranjos numéricos de apenas uma dimensao 
— nao se pode usar arranjos de cordao e multidimensionados. O exemplo que segue ilustra o di- 
mensionamento de dois corddes de 5 e 20 caracteres respectivamente, e um arranjo numérico 
com 13 elementos (0 até 12): 


WW DIM Sit¢S) Ses C25) -NB OTe) 


O numero que segue 0 nome da variavel corddo na declaracdo DIM é o comprimento maximo 
que o cordao pode ter durante o programa. O nimero que segue o arranjo numérico é o indice 
maximo que pode ser chamado dentro do arranjo. 

Na primeira vez que o Applesoft encontra um arranjo, verifica se ele foi dimensionado. Se 
nao, ele automaticamente dimensiona o arranjo com indices que vao de 0 a 10 para cada dimensao 
usada. Assim, nao é necessario dimensionar um arranjo, a menos que ele necessite de mais de 
11 elementos em uma dimensdo. O exemplo seguinte dimensiona o arranjo de uma Unica dimensdo 


R$. Ele também dimensiona um arranjo inteiro de 21 elementos. 
2USs DIM R€C10)+RA C20) 


A lista de clientes do hotel do nosso exemplo anterior, com duas dimensOes pode ser dimen- 
sionada assim: 


Vie OEM HStGs tO) 


O nimero (ou ndmeros) que seguem Oo nome do arranjo na declaracado DIM é igual ao maior 
valor de indice que acessa uma posicao particular do arranjo. Lembre-se que os fndices iniciam em 
0. Assim R$(10) dimensiona a varidvel R$() para ter 11 elementos, ndo 10, porque os jndices 0, 
1, 2, 3, 4, 5, 6, 7, 8, 9, 10 s&o permitidos. H$(8, 10), da mesma forma, especifica um arranjo 
de duas dimensdes com 99 entradas, porque a primeira dimensao pode ter valores 0, 1, 2, 3 etc., 
enquanto o segundo pode ter os valores de 0 até 10. 


Redimensionando Arranjos 


Uma vez dimensionada uma variavel arranjo, ela ndo pode ser redimensionada sem que o programa 
volte a ser rodado desde o inicio. As referéncias subsequentes nado podem usar jndices maiores do 
que o declarado; cada indice deve ser um numero compreendido entre 0 e o nimero usado no 
dimensionamento. 


COMANDOS DE SALTO 


As declaracgoes dentro de um programa BASIC sao executadas dentro de uma ordem ascendente 
de numeros de linhas. A sequéncia de execucdao foi explicada anteriormente neste capitulo, quando 
foram descritos os numeros de linha. As declaracdes de salto alteram a sequéncia de execucao. 
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Declaragao GOTO 


O GOTO é uma declaracdo simples; ela permite especificar a declaracdo que sera executada a se- 
guir. Considere o sequinte exemplo: 


20 A=4 
30 GOTO 100 
40 
50 
60 
70 
80 
90 
100 
110 
etc. 


A declaragdo da linha 20 é de atribuicao; ela atribui um valor 4 variavel A. A préxima declaracdo 
é um GOTO; ela especifica que a execucdo do programa deve saltar para a linha 100. Assim a exe- 
cucao do programa seguira a sequéncia: linha 20, linha 30, e entao linha 100. 

Claramente, alguma outra declarag¢do deve fazer o programa voltar para a linha 40, de outra 
forma a declaracao dessa linha nunca seria executada, como mostrado acima. 

Pode-se saltar para qualquer linha, mesmo que ela nao tenha nada além de um comentario. 
Entretanto, 0 computador ignora 0 comentario e tudo se passa como se 0 salto tivesse sido para a 
linha sequinte. Por exemplo, veja o seguinte salto: 


20 A=4 

30 GOTO 70 

40 

50 

60 

70 REM ESTA LINHA SO TEM COMENTARIO 
80 

90 

etc. 


A execucdo do programa pula para a linha 70; la nado existe nada além de um comentario, 
assim Oo computador vai para a linha 80; executando a declara¢ao la contida. Entéo, mesmo que se 
possa saltar para um comentario, é como pular para a linha seguinte. Isso pode ser ilustrado como 
segue: 

an A=4 

30% GOTO 80 

40 

50 

60 

70 REM ESTA LINHA SO TEM UM COMENTARIO 
*80 

90 

etc. 
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Tentar saltar para uma linha que nado existe causa uma mensagem de erro. 


Declaragao GOTO Calculada 


Existe mais um tipo de declaragdo GOTO que permite ao programa saltar logicamente para uma, 
duas ou mais linhas diferentes, dependendo do valor atual de uma expressao numérica. 
Veja a sequéncia de declaracdes do Integer BASIC: 


10 
20? 
30, A=B-3 
40% GOTO 30#A + 50 
A=0/450 
60 
70 
A=1 80 
90 
100 
110 
120 
etc. 


A=2 


A declaracado da linha 40 6 um GOTO cal/culado. Quando esta declaracdo é executada, a ldgica do 
programa vai saltar para o nUmero de declaracdo obtido calculando a expressao. Neste exemplo, 
pula para a declaracado 50 se a variavel A=O, para a declaracao 80 se a variavel A=1, enquanto 
que A=3 causa salto para a declaracdo 110. Se a linha calculada nado existe o computador manda 
a mensagem *** BAD BRANCH ERR. Note que se atribui o valor a varidvel A na declaracao 30. 
O valor de A depende do valor atual de B. O exemplo nao mostra como B é obtido; entretanto, se 
B tiver os valores 3, 4 ou 5, a declaracao da linha 40 causara um salto. 

Para testar a declaragdo GOTO calculada no integer BASIC, digite o seguinte programa: 


2 REM TNTOTALIZA VARTAVEL B 
1 Bs4 

>20 PRINT B 

30 ARB 

>4 GOTO 30eAt8O 
49 REM B=3 

»§Q END 

79 REM B4 

780 PRINT 8 

SOP Bank 

sing GeTO 20 

P10 REM B= 

>14 PRINT B 

420 Bea 

140 GOTO BO 


Agora execute esse programa digitando RUN. 
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Pode-se contar a seqléncia na qual os digitos aparecem? Tente reescrever o programa de 
forma que cada numero seja mostrado uma vez, na seqUéncia: 345345345... 


O Applesoft tem uma versdo um pouco diferente do comando GOTO calculado, como se vé 
abaixo: 


A% = 1 wWlO 
(° 
30, A%=B%-2 
404 ONA% GOTO 10, 70, 150 
50 
60 
A% =2 7O 
80 
90 
100 
110 
120 
130 
140 
he = 3 “150 
160 
etc. 


A declaracaéo na linha 40 é a forma de GOTO calculada do Applesoft. Quando esta decla- 
racdo 6 executada, a ldgica do programa tende para a declara¢ado 10 se a varidvel A%=1, para a 
declaracdo 70 se A%=2, e A%=3 causa um salto para a declaracao 110. Se A% tiver valores dife- 
rentes de 1, 2 ou 3, o programa continua na linha 50. 

A expressdo numa declaracgdéo GOTO calculado dentro do Applesoft é avaliada e seu valor 
determina para qual linha pular a partir da lista de nUmeros de linhas da declaragdo GOTO calcu- 
lado. Se o valor é 1, usa-se 0 primeiro numero de linha, se o valor for 2 usa-se o segundo numero 
e assim por diante. Se o valor for 0 ou exceder a quantidade de numeros de linhas de lista, o 
programa vai para a declaracao seguinte a declaracao GOTO calculado. 

O seguinte programa do Applesoft mostra como a declarag¢aéo GOTO calculado opera: 

10 BZ = 4 
20 PRINT BZ 
3O AA = BA - 2 


40 ON AZ GOTO 10,70,150 
7O FRINT BZ 

83O BAYA = & 

20) BOAT BO 

150 PRINT BZ 

140 BA = 3 


170 GOTO oO 


LOOPS 


As declaracoes GOTO e GOTO calculado permitem criar qualquer sequéncia de declara¢gdes que a 
l6gica do programa precise. Mas suponha que se necessite executar uma instru¢ao (ou grupo de 
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instrucdes) varias vezes. Por exemplo, suponha uma variavel arranjo A(1l) com 100 elementos e 
que cada elemento necessite ter atribuicdo com valores entre 0 e 99. Escrever 100 declaracdes de 
atribuicdo seria tedioso. E mais facil reexecutar uma mesma declaracdo de atribuicéo 100 vezes 
num loop. 


Declaracoes FOR e NEXT 


Pode-se criar um loop usando as declaracdes FOR e NEXT como segue: 


TO DIM Acegyy) 


20 FOR t= oO 99 STEP 4 
a0 ACT = 
af NEXT 1 


A declaracado ou declaracdes entre o FOR e o NEXT sao executadas repetidamente. Neste caso 
uma declaracdo simples de atribuicdo aparece entre o FOR e o NEXT; essa declara¢ao é executada 
repetidamente. Este tipo de estrutura de programa é chamado de /oop FOR-NEXT. 

Pode-se ver no exemplo abaixo um loop FOR-NEXT dentro do programa imprimindo os 
valores atribuidos ao arranjo A( ) dentro do loop. 


1 DIM ACS9) 
2 FOR T=) (0 99° STEP 4 
30 ACT =] 
aut PRINT AtL) 
%({) NEXT I 
Sf) ENB 
Quando se digita RUN o programa mostra 100 nimeros indo de 0 até 99. 

As declaracdes entre o FOR e o NEXT sdo reexecutadas o numero de vezes especificado 
pela varidve/ ‘ndice que aparece diretamente apds o FOR; no exemplo acima a variavel indice 
é 1. O | vai de O até 99 em passo (step) 1. 

A variavel | também aparece na declaracao de atribuicao em 30. Dessa forma, na primeira 
vez que a declaracado de atribuicado é executada, | é igual a O e a declaracdo é executada como: 


30 ACO) =0 


| 6 incrementada no tamanho do passo, que esta especificado na linha 20, como 1; 0 | assim sera 
1 na segunda vez que a declaracao da linha 30 for executada. A declaracao de atribuicao nessa 
segunda vez sera equivalente a: 


30 ACL )=4 


A variadvel | continua a ser incrementada pelo passo até que o valor maximo (99) seja obtido 
(ou ultrapassado). 

O passo nao tem que ser 1; ele pode ser qualquer numero inteiro. Troque o passo na linha 20 
e reexecute o programa. Agora a declaracdo de atribuicado é executada 20 vezes, desde que incre- 
mentando | 19 vezes em 5 chega a 95; a vigésima vez leva a 100, que é maior que 99. Mantendo o 
passo em 5, pode-se permitir que a declaracdo de atribuicao seja executada 100 vezes aumentando 
o valor maximo de | para 500. Pode-se fazer essa modificacao? (Lembre-se de modificar também 
o DIM.) 
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O tamanho do passo nao precisa ser positivo. Mas se for negativo, o valor inicial de | deve ser 
maior que o valor final. Por exemplo, se o passo é —1 e desejamos inicializar 100 elementos de 
A(l) com valores de 0 a 99, pode-se reescrever a declarac¢do na linha 20 como segue: 


19 DIM ACEP) 

20 FOR T=9? TO 0 STEP ~-4 
20 ACT) =T 

20 PRINT ACT) 

40 NEXT I 

SO END 


Execute este programa para testar o passo negativo. 

Se o passo é 1 (esse 6 0 caso mais freqiiente), nado é necessario explicitar a defini¢do do passo. 
Na auséncia de definicdes, o BASIC assume que o passo é 1. 

Pode-se especificar os valores inicial e final do indice e o passo usando-se as expressGes que 
se desejar. Porém, deve-se fazer isso, para ndo complicar o programa desnecessariamente. Se for 
necessdrio calcular um desses valores, sera mais interessante fazer isso separadamente antes de 
iniciar o loop. 

Pode-se usar valores reais para os valores inicial e final do indice e para o passo no Applesoft. 
Nao é necessdrio explicitar o fndice na declaracdo NEXT dentro do Applesoft. Porém, se isso for 
feito, tornara o programa mais facil de ser entendido. 


Loops Aninhados 


A estrutura FOR-NEXT 6 chamada de /oop do programa, porque a execucao do programa vai do 
FOR ao NEXT, volta ao FOR, e fica em circulos. Esse tipo de estrutura é muito comum; quase 
todos os programas que se escrevem usando BASIC tém uma ou mais delas. Os loops sao tao co- 
muns que muitas vezes eles comp6dem estruturas aninhadas, uma dentro da outra, tal como sao 
armazenados jogos de panelas, uma dentro da outra. Pode haver qualquer numero de declaracdes 
entre um FOR e um NEXT. Freqiientemente existem dezenas e até centenas de declaracées. 
E dentro dessas dezenas ou centenas, outros loops podem ocorrer. O exemplo abaixo mostra um 
nivel simples de aninhamento: 


10 DIM AC99) 

20 FOR I=0 TO 99 STEP 1 

30 ACL)#I 

40 REM MOSTRA TODOS OS VALORES DE aAéT) Ja DADOS 
SQ FOR J=0 TO I 

40 PRINT AC.) 

70 NEXT J 

80 NEXT I 

90 END 


Freqiientemente aparecem estruturas complexas de loop, mesmo em programas relativamente 
pequenos. Aqui esté um exemplo, mostrando as declarag;c6es FOR e NEXT, mas sem as declara- 
cdes intermediarias: 
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20 FOR I=1 TO 10 
60 FOR X=25 TO 347 STEP 


100 FOR A=" TO 0 STEP -1 


140 NEXT A 
200 FOR B=25 TO 100 STEP 5 


(: 


230 NEXT B 
300 NEXT X 


i) 





S00 FOR Y=1 TO 20 STEP 2 


(— FOR FP=10 To 20 


450 NEXT F 
7QOQ NEXT Y 


1000 FOR Z=1 TO 10 


1070 NEXT Z 


1200 NEXT I 


O loop mais externo usa a variavel indice |; ele contém trés loops aninhados que usam os indices 
X, Ye Z. O loop X contém dois loops adicionais usando indice P. O ioop Z nao contém loops 
aninhados. 

As estruturas de loop sao muito faceis de visualizar e usar. Existe apenas um erro muito 
comum que deve ser evitado; nado terminar um loop externo antes de terminar um interno. Por 
exemplo, a seguinte estrutura de loop é ilegal: 

30 FOR I=1 TO 10 
£0 FOR X=25 TO 347 STEP 3 


100 NEXT I 


200 NEXT X 


Todo o programa deve ter algumas declarac¢des FOR e NEXT, desde que todo loop inicia 
com a declaracao FOR e termina com NEXT. 

Por exemplo, suponha que exista uma declaragdo FOR e duas NEXT. O primeiro NEXT 
termina o FOR de forma que o loop opere corretamente. Porém o segundo NEXT nao completa 
nenhum FOR, o que causa um erro. 
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Se nao se inclui a varidvel fndice na declaracdo NEXT em um programa no Applesoft, a 
l6gica do programa automaticamente termina os loops corretamente, uma vez que sO existe uma 
possibilidade de finalizar um loop a cada vez que um NEXT 6 encontrado. Caso haja duvidas 
sobre isso, veja o exemplo complexo mostrado na pagina anterior. Faca estudos adicionais envol- 
vendo estruturas mais complexas. 


DECLARACOES DE SUB-ROTINAS 


Quando se comeca a criar programas de tamanho maior, !ogo se percebe que existem pedacos de 
programa que sao necessdrios mais de uma vez dentro da estrutura. Por exemplo, suponhamos 
uma variavel arranjo (A()) que deve ser reinicializada em diferentes pontos do programa. Pode-se 
repetir as trés instrucdes que compdem o loop varias vezes, porque sao poucas instrucGes. 

Suponhamos agora que o loop tenha dez ou doze instrucdes que processam dados de algu- 
ma forma antes de fazer a inicializacao. Se tal loop precisar ser usado dentro do programa em 
varios pontos, redigitar todas as instrucdes toda vez que elas sao necessdrias pode exigir muito 
tempo, e mais importante, gastar memoria. Este conceito é ilustrado no exemplo abaixo: 


Inicio do ree 


+ 
: 


— 
i) 
ra 


Rotina repetida 


t 
| 


- 


etc 


Que tal separarmos as determinacdes que se repetem e usa-las em separado? 

Isso é precisamente o que é feito; o grupo de declaracdes em separado que é acessado dessa 
forma chama-se sub-rotina. 

Mas aparece um problema. Pular do programa para a sub-rotina é facil; ela tem um endereco 
inicial especifico. Mas, no fim da sub-rotina, como se pode voltar? 

Pode-se executar um GOTO em qualquer ponto em que se deseja ir para a sub-rotina. Isso é 
ilustrado como segue: 
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Numeros de linha escolhidos arbitrariamente 
Inicio do 


programa —~> 10 


100 GOTO 2000 
110 


190 GOTO 2000 Sub-rotinas 
200 i. 
j 2000 +— Inicio 


260 GOTO 2000 ————_ / 
260 
2150 -——Fim 
480 GOTO 2000 
500 
Retorno 


etc. onde? 


Mas, no final da sub-rotina, como voltar? Se duas ou mais declaracdes GOTO vao para a 
mesma sub-rotina, existem dois ou mais lugares para voltar apds conclui-la. A solucdo é se usar 
declaracdes especiais. No lugar de pular para a sub-rotina usando GOTO, usa-se uma declaracao 
GOSUB. 


A Declaracao GOSUB 


Esta declaracdo salta da mesma forma que o GOTO, porém além disso ela se lembra para onde 
deve voltar. Em “‘computés’’ dizemos que GOSUB chama uma sub-rotina. Isso pode ser ilustrado 
como segue: 


Sub-rotina 


_7~ 2000 >—— Inicio 


oF Lembra 


100 GOSUB 2000 110 
110 









2150 RETURN +— Fim 


Mae 


Vai para o 
numero de linha 
lembrado 
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A sub-rotina finaliza com uma declaragdo RETURN. Esta declaracao faz um salto de volta para a 
declarag¢ao que vem depois do GOSUB. Se o GOSUB era a ultima declaracdo de uma linha, o pro- 
grama retorna para a primeira declaracao da linha seguinte. 

O loop de trés declaracdes que inicializa o arranjo A(), se convertido para sub-rotina fica 
assim: 


TO REM PROGRAMA PRINOTP AL 
2Q REM PODE-SE DIMENSTONAR AS VARTAVETS 
20 REM DA SUBROTINA NO PROG.PRTINOTPAL 
4Q) REM E UMA BOA TDETA DIMENSTONAR TODAS 
“QO REM AS VARTAYVETS NOG THICTIO £2O FROGRAMA 
60 OTM AC?) 
70) GOSUB 2000 
SO REM MOSTRA ALO PARA MOSTRAR FIM TMERTS 
fO PRINT “SOL TQu" 
100 END 
SQ00 REM SUBROTINA 
2090 FOR L=1 JO 99 
eel) ACT as] 
2OG0 PRINT act) 
“04D NEXT I 
USO RETURN 


Declaragcao POP 


Sob certas circunstancias, pode-se ndo desejar voltar de uma sub-rotina para o ponto de onde ela 
foi chamada. Nesse caso se poderia tentar usar um GOTO para retornar, porém isso pode causar 
problemas, porque o BASIC retém na memoria o endereco em que deveria voltar. Nesses casos 
deve-se usar a declaracdo POP. De outra forma corre-se o risco de se obter um erro devido a acu- 
mulacao de enderecos de retorno nado usados por declaracdes RETURN. Tudo o que o POP faz é 
mandar o BASIC esquecer o ultimo endereco de retorno guardado. Assim pode-se usar um GOTO 
para ir para qualquer outro lugar no programa. 

Contornar o RETURN constantemente, usando POP’s em demasia para liberar safdas de 
sub-rotina através de GOTO nao é uma pratica muito aconselhavel, uma vez que torna o programa 
bastante confuso. 


Sub-rotinas Aninhadas 


As sub-rotinas podem ser aninhadas. Quer dizer, uma sub-rotina pode, por sua vez, chamar outra 
sub-rotina etc. Nao é necessdrio dar instrucdes especiais para que isso aconteca. Simplesmente é 
preciso dar-se a declaracdo GOSUB e finalizar a sub-rotina com RETURN. O BASIC se lembrara 
o numero da linha correto para cada sub-rotina aninhada. 

O programa seguinte ilustra sub-rotinas aninhadas: 
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1 REM PROGRAMA PRINCIPAL 

20 REM PODE-SE DIMENSIOMAR AS VARTAVETS 

20 REM DA SUBROTINA NO PROG.PRINCIPAL 

a REM E Ma BOR [DELTA DIMENSTONAR TODAS 

HQ REM AS VARTAVETS MO TNICTO po 

40 REM PROGRAMA PRINCIPAL 

7 DIM ACEP) 

A GOSUE 2000 

Of) REM MOSTRA ALGO PARA INFORMAR RETORNO CORRETO 

100 PRINT “ACABQN” 

110 END 
2000 REM SUBROTINA DE PRIMEITRO NIVEL 
2010 FOR T=Q TO 99 
2020 ACL)=1 
2030 GOSUB 2000 
2040 NEXT 1 
2050 RETURN 
ano REM SUBROTINA ANTNHADA 


S040 PRINT ACT) 
S020 RETURN 


Este programa move a declaragdéo PRINT A(I) para fora da sub-rotina da linha 2000 e a coloca 
numa sub-rotina aninhada, na linha 3000. Nada mais mudou. 

Enquanto seja aceitavel e até desejavel que uma sub-rotina possa chamar outra, ela nao pode 
chamar a si propria. Nem uma sub-rotina pode chamar outra que por sua vez chame a primeira. 
Isso 6 chamado recursividade e nao é permitida dentro do BASIC no Apple II. 


Declaragao GOSUB Calculada 


As ldgicas do GOTO e do GOSUB sao muito semelhantes. Elas so diferem no fato de que o GOSUB 
guarda o endereco de retorno para voltar. Assim, nado deve causar surpresa o fato de existir tam- 
bém uma declaracgdéo GOSUB que opere de forma similar ao GOTO calculado. O GOSUB calculado 
permite que se va para uma entre duas ou mais sub-rotinas dependendo do valor de uma expressao 
numérica. O GOSUB calculado também se lembra para onde deve voltar. Nao importa para qual 
sub-rotina ele va. Ao final da sub-rotina, chegando na declaracgdo RETURN, havera o retorno para 
0 ponto inicial de chamada. 

Pode-se usar sub-rotinas aninhadas usando declaracdes GOSUB, da mesma maneira que se 
pode usar sub-rotinas aninhadas usando declaracdes GOSUB normais. 

Vejamos a seguinte declaracdo do integer BASIC: 
FIND GOSUB AS D004 2000 
rtty REM 


A expressdo na linha 100 é um GOSUB calculado. Quando essa declaracdo é executada, a 
l6gica do programa pula para a linha cujo nimero é obtido calculando-se a expressao. Nesse 
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exemplo, pula-se para a linha numero 2000 se A=O, para a linha 2500 se A=1 e assim por diante. 
Se a linha cujo numero foi calculado ndo existe, aparece a mensagem *** BAD BRANCH ERR. 

A versdo Applesoft do GOSUB calculado opera de maneira semelhante a sua versdo do 
GOTO calculado. Aqui esta um exemplo: 


10 
T1100 ON A BOSUB 1O00.500, 5000. 2500 
17140 BEM 


Quando a declaracdo da linha 100 é executada, se A=1 a sub-rotina que inicia na linha 1000 
é chamada. Se A=2, é chamada a sub-rotina que inicia na linha 500. Se A=3, é chamada a sub- 
rotina que inicia na linha 500 e se A=4, é chamada a sub-rotina que inicia na linha 2300. Qualquer 
outro valor de A diferente de 1, 2, 3 e 4 faz o programa ir para a linha 110, sem desviar para ne- 
nhuma sub-rotina. 


EXECUCAO CONDICIONAL 


As declaracdes GOTO e GOSUB condicionais sdo declaracdes condicionais. Isto é, a sequéncia de 
execu¢ao do programa depende dos valores de uma ou mais varidveis que podem mudar durante 
a execucao do mesmo. O fluxo do programa depende da condicao de variaveis. 


Declaracao IF-THEN 
Outra declaracao condicional é a declaracao IF-THEN. Ela tem a forma geral: 
IF expressao THEN declaracao 


Se a expressao é verdadeira, entao a declaracao é executada. As expressdes relacionais e Booleanas 
sao muito comuns com declaracdes IF-THEN, embora express6es aritméticas possam ser usadas da 
mesma forma. Isso da ao programa BASIC um poder real para tomar decisdes. Aqui estado trés 
exemplos simples de declaracées IF-THEN: 

10 TF A=6B+5 THEN PRINT MSGS 

@Q TF COés "4M" CHEN DM=1) 

SO LF @¢14 AND M4M1 THEN GOTO 46 


~ 


* 
L, 


A declaracao na linha 10 causa a execucdo da declaracado PRINT se o valor da variavel A 
for igual ao valor da varidvel B mais 5. Em outro caso a declaragao PRINT nao é executada. 

A declaracao da linha 40 atribui o valor numérico O @ variavel IN se a varidvel cordaéo CC$ 
for a letra M. 

A declaracao da linha 50 causa o desvio do programa para a linha 66 se a variavel OQ for me- 
nor que 14 e a variavel M for menor que M1. De outra forma, a execucao do programa continua 
na linha seguinte. 

Se houver dificuldade de entender a expressdo que segue o IF, volte a discussdo de expres- 
sdes dadas antes neste capitulo. 

Uma declaracaéo IF-THEN pode ser seguida por outras declaracdes na mesma linha de pro- 
grama. Qualquer declaracdo posterior na mesma linha de programa é sempre executada, nado impor- 
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tando se a expressdo do IF-THEN é verdadeira ou falsa. Podemos ver isso no exemplo: 


to TF oat THEN PRINT "COMPLETO"! 8OSUB 2o00 
OO Te ToUaPR ENT 7 


No exemplo acima, 0 programa imprime a expressio COMPLETO apenas quando a variavel 
V é maior que 100. O programa chamara a sub-rotina na linha 2000, nado importa qual seja o valor 
de V. 

O Applesoft executa a declaracdo que segue o IF-THEN na mesma linha apenas quando a 
declaracdo for verdadeira. Se a expressdo é falsa, a execucao do programa pula para baixo paraa 
proxima declaracao da linha seguinte. No exemplo acima, o programa imprime a expressdo COM- 
PLETO e vai para a sub-rotina na linha 2000 apenas se V for maior que 100. Se V for menor ou 
igual a 100, o programa nao imprimira a mensagem nem ira para a sub-rotina, indo diretamente 
para a declaracao da linha 20. 

Existe uma forma especial da declaragdo |F-THEN no Appiesoft. Sempre que a atitude a ser 
tomada condicionalmente for uma declaracdo GOTO, pode-se omitir a palavra THEN se desejado. 
As duas declaracdes seguintes sao equivalentes: 


110 TF Mmnt=DOE THEN GOTO AND 
é O mesmo que: 


HMO TF MMg=poe GoTo ton 


 ¢ 


DECLARAGOES DE ENTRADA E SAIDA 


Existe uma variedade de declaracdes no BASIC que controla a transferéncia de dados de e para o 
computador. A colecdo delas 6 chamada de declaracdes de entrada/saida. As declaracGes de entra- 
da/saida mais simples controlam a entrada de dados pelo teclado e a sajda para a tela. Discuti- 
remos essas declaracdes nos pardgrafos que seguem. Porém, existem declaracdes de entrada/safda 
mais complexas que controlam a transferéncia de dados entre o computador e dispositivos perifé- 
ricos, tal como o gravador cassette, o drive de disco e a impressora. Essas declaragdes mais com- 
plexas sdo tratadas nos Capitulos 4 e 5. O Capitulo 6 trata de declaracdes de safda na tela para 
graficos. 

Ja vimos a declaracdo PRINT, que faz sair dados para a tela. Entao, vamos ver esta decla- 
racdo primeiro, antes das declaracdes de entrada. 


Declaracado PRINT 


Por que usar PRINT no lugar de DISPLAY ou outra abreviacdo da palavra display? A resposta vem 
dos anos sessenta, quando a linguagem BASIC foi criada, os videos eram muito caros e em geral 
inacessiveis aos computadores de médio e baixo custo. Os terminais mais comuns para compu- 
tadores tinham um teclado e uma impressora. A informacado em geral era impressa ao invés de 
mostrada num video, tal como nos dias de hoje. Assim a palavra PRINT, “imprima’’ em inglés, 
descreve a declaracao que faz mostrar informacao na tela do video. 

A declaracao PRINT mostra texto e nimeros. Por exemplo, a declaracao seguinte vai mostrar 
na tela a palavra TEXTO: 
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TO PRINT “TEXTO“ 


Para mostrar numeros, coloca-se um numero, ou o nome de uma varidvel apdés a palavra 
PRINT, como aqui: 


A= TO 
SPRINT SA 
a 10 


A declarac¢ado acima mostra o numero e o numero constante na variavel A, que é 10, na mes- 
ma linha. 

Pode-se mostrar uma mistura de textos e/ou numeros, listando a informacao a ser mostrada 
apos a declaragao PRINT. Usa-se virgulas para separar cada item. A declaracdo PRINT a seguir 
mostra as palavras UM, DOIS, TRES, QUATRO e CINCO, seguidas do numeral que representa 
cada numero: 


1O PRINT "UM", 1,.°DOIS",.2,”"TRES” +3, “QUATREO”, 4, "CINCO" ,5 
20) END 


Pode-se separar as variaveis com virgulas, como feito acima, de forma que o Apple || automa- 
ticamente aloca um numero fixo de espacos para cada varidvel mostrada. Tente executar a decla- 
ragao acima em modo imediato para ver por si proprio. Se for desejado eliminar os espacos em 
branco, basta separar as varidveis com o sinal ponto-e-virgula (;), como abaixo: 


40 PRINT *UM" $43 “DOTS* #25 “TRESS” 237 “QUATKO”* 245 “CINCO* $5 
2Q) END 


Tente também esta variacao para ver como o ponto-e-virgula funciona. 

Uma declaragdo PRINT automaticamente retorna o cursor para a margem esquerda e desce 
uma linha depois da Ultima acdo. Em “‘computés”’ diz-se que foi dado um carriage return (retorno 
do carro). Pode-se suprimir o retorno do carro colocando uma virgula ou ponto-e-virgula apdés o 
Ultimo item da lista do PRINT. Uma virgula nessa posic¢do move o cursor para a proxima locali- 
zac¢ao onde um valor seria mostrado, caso existisse. Para ver isso, digite 0 programa seguinte e 


execute-o digitando RUN: 


TO PRINT “UM +4 
20 PRINT “DOIS" +2 
20 END 


Agora coloque uma virgula ao final da declaracdo na linha 10 e reexecute o programa com 
RUN. Vé-se entdo a concatenacao da linha 20 com a linha 10 na mesma linha da tela. 

Em seguida substitua a virgula da linha 10 com o ponto-de-virgula e rode o programa com 
RUN. As duas linhas s4o concatenadas de novo, porém o espaco entre o numeral 1 e a palavra 
DOIS foi removido. Trocando outras virgulas por pontos-e-virgulas pode-se ir retirando os espacos 
em branco existentes entre os itens. 

Mostramos os numerais colocando-os diretamente na declaracdéo PRINT. Pode-se além disso 
mostrar numerais como contetdo de variaveis. O programa seguinte fara o mesmo que o primeiro 
exemplo da declaracdo PRINT, porém usa o arranjo A() para criar os digitos. Tente colocar o 
programa e roda-lo. 
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2 DIM ACS) 

10 FOR T=1 TO 3 

2Q ACTO=T1 

30 NEXT f 

40 PRINT “UM“FACTIS “DOTS” FAC" TRES“ FACSI 2 QUATRE OT FACS IE 
“CINCOS FACT) 

JO END 


No Applesoft, podem-se colocar as palavras a serem mostradas numa variavel cordao e colo- 
car a declaragdo PRINT dentro de um loop FOR-NEXT, alterando o programa como mostrado 
abaixo: 


10 DATA “UM", “DOTS”, “TRES”. “QUATRO”®» “CINCO” 
20 FOR Leq TO 5 

4{Y READ NE 

20) PRINT Ns]? 

40 NEXT I 

7) END 


Declaracao INPUT 


Quando uma declaracdo é executada, o computador espera por entrada de informacao pelo tecla- 
do; enquanto nao for colocada a informacao desejada, tudo fica parado. 

Na sua forma mais simples, a declaracdo INPUT inicia com a palavra INPUT seguida do nome 
da varidvel. O dado entrado pelo teclado é atribufdo aquela variavel. O tipo do nome da variavel 
determina o tipo de dado que deve ser colocado. Um nome de variavel numérica é satisfeito com 
uma variavel numérica. Para mostrar a entrada numérica, digite o programa sequinte e execute-o 
(tente colocar letras e veja o que acontece): 


WW) INPUT 4A 

ae PRINT &@ 

we REM FIM DE PROGRAMA SE ACHAR O 
2Q TF &=0 THEN END 

4f) GOTO 10 


Na execucdo da declaracéo INPUT, o computador mostra um ponto de interroga¢do, e espe- 
ra a entrada do dado. No programa acima, aparece cada tecla tal como foi digitada. Em ‘’com- 
putés’’ a tela ecoa o teclado. Além disso, o n&Umero é mostrado duas vezes devido a declaracao 
PRINT na linha 20. A primeira aparicdo do n&mero ocorre na execucao da declaracao da linha 
10, quando se faz uma digitacdo pelo teclado. A segunda apari¢ao ocorre em respostas a decla- 
racao da linha 20, o PRINT. 

A declaracdo INPUT pode entrar mais de uma variavel de uma sO vez. Para isso, liste todas 
as varidveis que deseja entrar depois da palavra INPUT. Separe as variaveis com virgulas. Quando 
esse INPUT 6 executado, deve-se responder com um valor para cada variavel. Certifique-se que o 
valor digitado seja do mesmo tipo da variave! associada a ele. 

Quando se responde a uma declaracao INPUT, nao utilize virgulas para pontuar ndmeros 
grandes; entre 1000 e nao 1.000. 
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O exemplo seguinte entra dois valores numéricos mostrando em seguida o que foi entrado: 


20 INPUT AvB 

30 PRINT A+B 

ou REM FIM DE EXECUCAO QUANDO ENTRA 0 
4f) TF A=Q OR B=0 THEN END 

“0 GOTO 20 


Rode o programa acima e tente entrar um numero seguido por virgula, depois outro numero, 
e em seguida a tecla RETURN. Agora tente algo um pouco diferente. Entre um numero e digite 
a tecla RETURN. Como se pode ver, o Apple || informa que se deve digitar o outro numero. Entdo 
coloque o outro numero e acione RETURN. Vemos assim que quando a declaracdo INPUT pede 
mais de um valor numérico, existe a escolha de se digitar tudo dentro de uma mesma linha ou em 
linhas separadas. 

A declaracao INPUT opera de uma forma um pouco diferente quando se trata de varidveis 
tipo cordao no Integer BASIC. Antes de tudo, ele nao coloca o ponto de interrogacdo; tente o 
exemplo: 


10 DIM AGC19) 

2Q INPUT As 

30 PRINT As 

35 REM FIM DE PROGRAMA COM ENTRADA NULA 
4M) TF Ag="" THEN END 

30 GOTO 20 


Na execucdo do programa acima, tente entrar um cordao com mais de 19 caracteres. Apare- 
cera a mensagem *** STR OVFL ERR e o programa pararad. O comprimento do cordao entrado 
nao pode exceder o comprimento maximo da varidvel cordao usada como variavel no INPUT. 

O Integer BASIC forca que se entre cada variavel numa linha diferente. Se a declaracao 
INPUT especifica uma lista de varidveis, e existem variaveis tipo cordao na lista, os valores tipo 
cordao respectivos devem ser entrados em linhas diferentes. Isso acontece porque o Integer BASIC 
permite que se coloquem virgulas como parte da varidvel cordao. Veja isso rodando o exemplo 
acima e colocando a variavel PAO, MANTEIGA. O exemplo seguinte mostra o que acontece 
quando uma variadvel cordao faz parte de uma declaracdo INPUT no Integer BASIC. Tente com 
este programa; tente entrar todos os quatro valores na mesma linha, separados por virgulas. O que 
aconteceu? Tente colocar cada valor numa linha diferente. Veja o que acontece quando se tenta 
entrar um valor numérico ou virgula como parte de um valor tipo cordao. 


10 DIM ASC 10),BEtC1O) 

20 IMFPUT A&,A,B&+B 

30 PRINT AS,A,BS,B 

Sh REM FIM DE PROGRAMA COM ENTRADA NULA 
4) ITF Ag=°" THEN END 

3O GOTO 20 


Como foi discutido antes, qualquer varidvel real pode ter um valor inteiro no Applesoft. 
Assim pode-se entrar um nimero inteiro para uma variavel real. Um valor real entrado para uma 
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varidvel inteira 6 convertido para valor inteiro de acordo com as regras de truncagem apresentadas 
na secdo “’Express6es do Tipo Misto”’ neste capitulo. 


Caracteres da Declaragao INPUT 


A declaracdo INPUT é muito fastidiosa; sua sintaxe 6 pesada para qualquer operador humano 
normal. Imagine um operador novato de escritério que nado entenda nada de programac¢ao; encon- 
trando os tipos de mensagens de erro que aparecem se uma virgula é colocada fora de lugar, certa- 
mente ele ficara desesperado. Em vista disso, pode-se perder muito tempo escrevendo programas 
“& prova de idiotices’’ na entrada de dados. Esses programas devem prever todos os tipos de 
enganos que se possam cometer na digitacdo de dados, e devem responder aos erros de forma 
simples e incisiva de maneira que o operador possa entender. No Capitulo 4 se descrevem essas 
técnicas de programacao de entrada de dados em detalhes. 

Uma forma interessante de orientar o operador na declaracao INPUT é sua habilidade de 
colocar uma pequena mensagem que descreve a entrada desejada. Chamamos essa mensagem de 
mensagem de entrada. Ela aparece na declaracado INPUT como um cordao entre aspas, e é colocada 
a frente da entrada desejada. Essa mensagem permite colocar varias variaveis dentro de uma mesma 
declaracdo INPUT, auxiliando a memoria sobre o que deve ser entrado. 

No Integer BASIC, coloca-se a mensagem imediatamente apds a palavra INPUT, e segue-se 
a lista de varidaveis. Quando a lista contém mais de uma variavel, a mensagem aparece apenas uma 
vez, na primeira linha de entrada. Se a primeira varidvel da lista é numérica, aparece um ponto de 
interrogacéo apés a mensagem. Se a entrada for cordao, nao aparece a interroga¢cdo. Aqui esta um 
exemplo: 


TQ DIM Ag¥¢ 10) 

20 INPUT “ENTRE SEU NOME E IDADE “,A#%,A 
3Q PRINT AGEs” TEM FA 

oo REM “ENTRADA NULAS=F IM DE PROGRAMA” 
SQ TR aAg= THEN ENB 

“il GOTO 20 


No Applesoft, coloca-se a mensagem apos a palavra INPUT. Ela é seguida por dois pontos e 
depois vem a lista de varidveis. A existéncia de dois pontos suprime o ponto de interrogacdo. A 
mensagem aparece apenas uma vez, mesmo que seja necessdria mais de uma linha para entrar 
todas as variaveis. 

Aqui esta um exemplo em Applesoft: 


20 INPUT “ENTRE SEU NOME E TDADES “:A¢,A 
30 PRINT AGF “TEM TFA 

20 REM “USE CTRL-f PARA FINALT ZAR” 

20 GOTO 20 


A Declaragao GET 


A declaracéo GET, disponivel apenas no Applesoft, entra um Unico caractere do teclado. Esse 
Caractere ndo aparece na tela. Nao é preciso digitar o RETURN apos a digitacao. Essa entrada é 
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tratada como uma variavel cordao ou como um valor numérico, dependendo da varidvel que segue 
a palavra GET. Digite o sequinte programa e execute-o: 


10 GET At 

2Q) FRINT AG 

eu REM “SE A ENTRADA FOR E, FIM DE PROGRAMA” 
30 IF At="E” THEN END 

40 GOTO10 


Pode-se fazer a declaragdo GET esperar por um caractere especifico, testando a entrada, como 
segue: 


10 GET As 

2eQ [TF AS<>°X” THEN GOTO 10 
30 PRINT Ag 

4“{) END 


Este programa espera pela digitacao da letra X. Fora isso nada acontece. 

Se a declaracdo GET especifica uma varidvel real ou inteira a entrada deve ser numérica. Em 
caso contrario ocorre uma mensagem ?SYNTAX ERROR e o programa para. Devido a esse e a 
outros problemas que podem ocorrer com a declaragdo GET, em geral ela so é usada para receber 
caracteres tipo cordao. 

Os programas usam a declaracdo GET mais frequentemente quando dialogam com o opera- 
dor. Por exemplo, um programa pode esperar a decisdo de um operador aguardando dele (ou dela) 
O Caractere “’S” para “SIM’’. Aqui segue um exemplo dessa Idgica: 


TO PRINT “OPERADOR, VOCE ESTA AT 7?” 
15 PRINT “DIGITE SIM OU NAG” 

2QO GET At 

30 ITF AS<>°Y" THEN GOTO 20 

4Q PRINT “OK, VAMOS CONTINUAR ! ” 

WO) END 


Note que essa seqUéncia nunca mostra o caractere entrado no teclado. Tente reescrever 0 programa 
de forma que qualquer caractere digitado na declaracdo GET seja mostrado na tela. 


EXECUCAO DE PARADA E CONTINUACAO DE PROGRAMAS 


Se um programa estiver rodando e se desejar para-lo, basta digitar CTRL e C simultaneamente. Se 
O programa estiver esperando por entrada de teclado através de uma declaracdo INPUT, ao se acio- 
nar CTRL-C, deve-se seguir com o acionamento da tecla RETURN. 

No Integer BASIC, aparece a mensagem STOPPED AT e 0 numero da linha onde parou a 
execu¢ao do programa. Ele continua se for dado o comando CON. 

No Applesoft, a mensagem 6 BREAK IN seguida pelo nimero da linha onde a execucao pa- 
rou ao se acionar CTRL-C. A execucdo continua com o comando CONT. 
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A Tecla RESET 


E claro que se pode interromper o programa com a tecla RESET (ou CTRL-RESET em algumas 
versdes do Apple II). 

No Apple II Plus e no Apple II com o Language System instalado, o RESET tem o mesmo 
efeito que o CTRL-C. 

Nas versdes do Apple II sem o Autostart Monitor, o acionamento do RESET causa o apareci- 
mento do caractere de entrada do monitor ( * ). Se se estiver usando o Integer BASIC ou o Firm- 
ware Applesoft, digite CTRL-C para retornar para a linguagem que estava usando. Se o sistema for 
o Applesoft baseado em cassette, digite OG para retornar ao Applesoft. Se o sistema for Applesoft 
baseado em disco, digite 3D0G para retornar ao Applesoft. 

Caso se tente voltar incorretamente a partir de um RESET acidental, o programa em BASIC 
estara perdido. 


A Declaragao END 


O programa para sua execucao quando encontra a declaracdéo END, como foi descrito anterior- 
mente, neste capitulo. 
Nao se pode continuar a executar o programa, se for encontrado em END no Integer BASIC. 


A Declaracao STOP 


O Applesoft tem outro comando que para a execucdo do programa quando encontrado: o coman- 
do STOP. Quando o Applesoft executa o comando STOP, aparece a mensagem BREAK IN seguida 
pelo numero da linha onde o programa parou. 

Pode-se continuar a execucdo digitando CONT. 


A Declaracao WAIT 


O Applesoft tem uma declaracdo que permite especificar uma pausa na execucdao do programa. A 
declaracdo WAIT faz o programa parar até que a posicao de memoria especificada tenha um valor 
também especificado. Pode-se, por exemplo, parar o programa até que alguém aperte o botado no 
controlador de jogo 1. Aqui esta como: 


10 REM ESPERA POR BOTAQ NO CONTROLADOR DE JOGO 1 
20 PRINT “ACTONE © BOTAG NO CONTROLADOR DE JOGO 1 


SO WATT ~- 14286,128 
4f) PRINT “BANG!” 
"f) END 


Consulte o Capitulo 8 para maiores detalhes sobre a declaracdo WAIT. 
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FUNCOES 


Outro elemento do BASIC é a funcdao, que de certa forma se parece com uma variavel, mas pode se 
comportar mais como uma declaracado BASIC. 

Talvez a melhor forma de se entender o que a funcdao faz é através de um exemplo. Na decla- 
racao seguinte: 


J1D A#sSGk C8} 


a variavel A é colocada como a raiz quadrada da varidvel B. O SOR especifica a funcao raiz quadra- 
da. Veja a seguinte funcao em cordao: 


ety LeleN ¢ Dp) 


Nesse exemplo, a varidvel L é colocada como sendo o comprimento da varidvel D$. 

As funcdes podem substituir varidveis ou constantes em qualquer lugar numa declaracdo 
BASIC, a excecdo da esquerda do sinal de igual. Em outras palavras, pode-se dizer A=SOR (B), 
mas nao é permitido dizer SQR(A)=B. 

Em seguida veremos como funcionam as funcdes e como usa-las. Mostraremos aqui um 
sumario incompleto das funcgdes permitidas no Integer BASIC e no Applesoft. Uma descricdo 
completa das funcdes foi colocada no Capitulo 8. Muitas das fun¢des nao sao permitidas no 
Integer BASIC. Isso sera indicado no momento apropriado. 

Especifica-se a funcdo através de uma palavra reservada apropriada (como SOR para raiz 
quadrada), seguida por um argumento ou argumentos entre parénteses. No caso de A=SOR(B), 
SOR requer apenas um argumento, que no caso é o valor de onde deve ser extrafda a raiz quadra- 
da. Para L=LEN(D$), LEN especifica a funcdo e o argumento D$, entre parénteses, que 6 o 
cordao do qual se obtém o comprimento. 

Na forma geral, qualquer funcao tera um desses dois formatos: 


Argumento Unico para a fun¢do 
que tenha apenas um argumento 


funcdo (arg1) 
funcao (arg1, arg2) 


L Dois argumentos para a fun¢ao que 


necessita de dois argumentos 


eee Palavra reservada para especificar a fun¢ao 


Poucas funcdes necessitam de trés argumentos. Cada argumento de funcdo pode ser uma 
constante, uma variavel ou uma expressdo. 
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Todas e cada uma das funcdes numa declaracado BASIC sao reduzidas a um Unico valor numé- 
rico ou cordao antes que qualquer outra parte da declara¢do BASIC seja calculada. Primeiro 0 argu- 
mento da funcdo é calculado de acordo com as regras mostradas antes. Uma vez reduzido a um 
valor numérico ou cordao, aplica-se a funcado ao argumento, obtendo-se outro valor numérico ou 
cordao. A expressdo nao é calculada até que todas as suas fun¢des sejam calculadas. Por exemplo, 
veja o seguinte exemplo: 


J10 BH=24,7# (SOR (0) +5)-SIN(O, 2+0) 


As funcdées SOR e SIN sao calculadas primeiro. Suponhamos SQR (C)=6.72 e SIN (0.2 +D)=0.625. 
A expressao na linha 10 sera primeiramente reduzida para: 


My 7 LH. fet) -D.629 


e depois esta expressdo simples é calculada. 


FUNCOES NUMERICAS 


Aqui esta uma lista de funcdes numéricas que podem ser usadas tanto em Integer BASIC quanto 
em Applesoft: 


SGN Retorna o sinal de argumento: +1 se argumento positivo, —1 se argumento nega- 
tivo, 0 para argumento Zero. 

ABS Retorna o endereco absoluto de um argumento. Um argumento positivo nao 
modifica; um argumento negativo é convertido para o positivo correspondente. 

RND Gera um nimero aleatério. Veja o Capitulo 8 para mais detalhes. 


Aqui esta uma lista de funcdes numéricas que sO podem ser usadas com o Applesoft: 


INT | Converte um argumento de ponto flutuante para seu inteiro equivalente. 
SQR_~ Calcula a raiz quadrada de um argumento. 

EXP Eleva aconstante ‘’e’”’ 4 poténcia que é o argumento. 

LOG Calcula o logaritmo natural de um argumento. 

SIN Retorna o seno trigonométrico do argumento, em radianos. 

COS__ Retorna o co-seno trigonométrico do argumento, em radianos. 

TAN  Retorna a tangente trigonométrica do argumento, em radianos. 


ATN_ Retorna 0 arco-tangente trigonométrico do argumento, em radianos. 


Usando Funcdes Numéricas 


Deve-se usar as funcdes numéricas tao cedo quanto possivel, mas nao se preocupe com as funcoes 
que lhe sdo desconhecidas. Por exemplo, caso nao exista o conhecimento sobre o comportamento 
das funcdes seno, co-seno e tangente, nado é aconselhavel colocda-las nos programas, posto que elas 
perdem o sentido. 
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Aqui estado alguns.exemplos que usam funcdes numéricas: 


TO Ats-234 

20 B=SGN CA) 
30 PRINT B 
40) END 


Na execucao deste programa, o resultado apresentado sera —1, porque —234 é negativo. Como 
exercicio, troque a declaracdo na linha 10 por INPUT. Troque a linha 40 para GOTO 10. Agora 
pode entrar uma variedade de valores de A e ver a funcao SGN funcionar. 

Aqui esta um exemplo mais complexo usando as funcdes numéricas do Applesoft BASIC: 


1Q INPUT A,B 

20 IF LOG (A) <¢ 0 THEN A=1/7A 

30 PRINT S@QR CA) * EXP ¢(B) 

3S REM USE CTRL-C PARA TERMINAR O PROGRAMA 
4f} GOTO 10 


Se houver dominio completo de sua parte sobre a funcdo logaritmo, troque a declaracao da linha 
20, substituindo a func¢ao LOG por outra fun¢do numérica qualquer. 


FUNCOES CORDAO 


As funcgdes cordao permitem o manuseio de dados tipo cordaéo numa variedade de formas. Pode 
nao ser necessdrio o uso de funcdes numéricas desconhecidas, mas é necessdrio um esforco para 
aprender todas as fun¢des que operam com os cordoes. 

Aqui vai uma lista de fungcdes que podem ser usadas tanto no Integer BASIC quanto no 
Applesoft: 


ASC Converte um cordao de caracteres no seu cddigo padréo numérico 
(cddigo ASCII!) equivalente. 
LEN Retorna o numero de caracteres contidos num cordao de texto. 


Aqui estao as fungdes de corddo que sé podem ser usadas com o Applesoft: 


STR$ Converte um valor numérico em um cordao de caracteres de texto. 

VAL Converte um cordao de texto em seu numero equivalente (se tal con- 
versdo for possivel). 

CHR$ Converte um cédigo numérico (ASCII) em seu equivalente caractere 
de texto. 

LEFT$ Extrai a parte esquerda do cordao de texto. Os argumentos da funcao 
identificam o corddo de texto e a parte da esquerda desejada. 

RIGHT$ Extrai a parte direita do cordao de texto. Os argumentos da funcdo 
identificam o cordao e a parte da direita desejada. 

MID$ Extrai uma parte do meio do cordao. Os argumentos da funcao identi- 


ficam o corddo e o pedaco desejado. 
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As funcées tipo cordaéo permitem determinar o comprimento de um cordao, extrair parte de 
um cordéo e converter valores numéricos, cddigos numéricos (ASCII), e caracteres do cordao. 
Essas funcdes usam um, dois ou trés argumentos. Aqui estao alguns exemplos: 


ST R$(14) Converte 14 para “14”. 

LEN(“ABC”) Retorna o comprimento do cordao. O nimero 3 volta porque o cor- 
dado tem 3 caracteres. 

LEN(A$+B$) Retorna o comprimento da concatena¢do dos dois cordées. 


LEFTS(ST$,1) Retorna o caractere mais a esquerda do cordao ST$. 


Subcordées do Integer BASIC 


Embora o Integer BASIC nao tenha funcdes que permitam extrair partes de um cordao, existe uma 
forma de fazé-lo. Especifica-se a posicdo inicial e o numero de caracteres num subcordao, como no 
exemplo que segue: 


10 DIM A$(20),BS¢(5) 
20 BS=AGC1, 4) 


No exemplo acima, B$ é colocado igual aos quatro primeiros caracteres de A$. Pode parecer que 
atribuiu-se a B$ o valor de um dos elementos de um arranjo tipo cordao chamado A$, mas lembre- 
se de que o Integer BASIC nao permite arranjos tipo cordao, muito menos tais arranjos com duas 
dimens6es. Perceba bem que tal notacdo se refere a um subcordao. 

O primeiro valor entre parénteses 6 a posicdo inicial do subcordao e o segundo valor é o 
ndmero de caracteres do subcordao. 


Concatenacgao de Corddes no Integer BASIC 


A funcaéo LEN permite que se concatene corddes no Integer BASIC. Aqui esta um exemplo: 


10 DIM A$C10),BS$°10),C$C10) 
2Q AS="VENTO” 

30 B$=" TNHA” 

4) C$="CATA” 

“QO ASCLENCAGI +17) =8$ 

60 PRINT A$ 

7Q CSC LENCC$)4+7>=AF 

BO PRINT B¢ 

90 END 


> RUN 
VENTOTNHA 
CATAVENTOINHA 
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FUNCOES DO SISTEMA 


Para efeito de complementacao, as funcdes do sistema sao listadas abaixo. Elas executam opera- 
¢des que nado terdo maior interesse até que se tenha experiéncia em programacao. 
Aqui esta a lista de funcGdes do sistema disponiveis: 


PEEK Pega o contetido de uma posi¢ao de memoria. 

FRE Retorna o espaco livre disponivel — o numero de bytes de memoria RAM. Nao 
permitido no Integer BASIC. 

USR Transfere a execucao para um programa em linguagem assembler. Nao permi- 


tida no Integer BASIC. 


FUNGOES DEFINIDAS PELO USUARIO 


Além das varias funcdes que sao disponiveis dentro do BASIC padrao, pode-se definir funcdes 
aritméticas prdéprias do usudrio no Applesoft, uma vez que elas nao sao muito complicadas. Fun- 
¢des tipo cordao definidas pelo usudrio nado sao permitidas. Uma declaracado DEF FN define a 
funcado. Chama-se a funcao com declaracaéo FN. Aqui esté um pequeno programa que usa a decla- 
racao DEF FN: 


10 DEF FN FOX) = ANDex 

2Q INPUT A 

20 PRINT AyFN PCA) 

So REM USE CTRL-C PARA SATR DO PROGRAMA 
40 GOTO 20 


O identificador da funcao segue a palavra reservada FN. As regras para batizar o identifi- 
cador sa4o as mesmas usadas para dar nomes a variaveis reais. No exemplo, usamos P, de forma 
que a funcdo passou a se chamar FNP. Se o identificador fosse AB, 0 nome da func4o seria 
FNAB. 

A expressao aritmética do lado direito do sinal de igual define a funcao. Quando se chama a 
funcaéo com a declaracdo FN, a expressdo é calculada (usando os valores correntes de qualquer 
varidvel mencionada na expressdo). O resultado numérico obtido é tratado da mesma forma que 
qualquer outro valor numérico no contexto onde a declarag¢ado FN aparece. 

Na declaracdo DEF FN, uma Unica varidvel deve seguir o identificador da funcao, e deve 
ser colocada entre parénteses. O nome da variavel é local, dentro da defini¢ado da func¢ao; ele nao 
tem efeito fora da declaracdo DEF FN. Pode-se usar o mesmo nome de variadvel em qualquer outro 
local do programa sem afetar a funcdo, e a varidvel na funcao nao afetara outro nome de variavel 
idéntico em outro local dentro do programa. 

Em uso, a declaracgdo FN deve ser seguida pelo identificador da fun¢do, que deve ser seguido 
por uma constante numérica, varidvel ou expressdo entre parénteses. Quando o Applesoft encontra 
uma declaracaéo FN, ele atribui os valores da constante, da varidvel ou da expressao as variaveis 
locais da declaragdo FN. (O valor de uma varidvel fora da declara¢do DEF FN que tenha 0 mesmo 
nome da variavel local ndo é alterada.) Se a variavel local aparece na expressdo que define a funcao, 
o Applesoft usa seu valor mais recentemente atribuido para calcular a expressdo. 
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FUNCOES ANINHADAS 


O argumento de uma funcdo pode ser uma expressdo; a expressdo pode conter funcdes. Em outras 
palavras, as funcdes podem ser aninhadas. Aqui esta um exemplo: 


{QO INPUT 4 

2Q PRINT SGNC ABS AD) 

2a REM USE CTRL-C PARA FINALTZAR 9 PROGRAMA 
30 GOTO 40 

4f) END 


Realize experiéncias criando declaracdes PRINT em modo imediato para fazer uso mais complexo 
das funcdes numéricas e de cordao. 


4 


Programacao Basic Avancada 


Este capitulo continua as orientacdes do Capitulo 3 de como programar o Apple || em BASIC. 
Ele cobre outras declaracdes novas em BASIC e explora diferentes facetas das declaracGes ja vistas. 
O Capitulo 3 mostrou como fazer seu Apple |! realizar algumas funcGes interessantes; este capitulo 
mostra como torna-lo uma ferramenta realmente Util. 


ACESSO DIRETO E CONTROLE 


Existem algumas declaragdes que permitem acessar diretamente o Apple ||. Existem muitas coisas 
que se podem fazer através delas — como operar controladores de jogos, operar os alto-falantes e 
fazer pleno uso dos dispositivos periféricos. 


MEMORIA E ENDERECAMENTO 


O Apple || pode ter até 65.536 locais de memoria enderecaveis individualmente, sendo que cada 
um pode conter um nimero variando entre 0 e 255 (este limite um tanto estranho é, na verdade, 
2 elevado ao expoente 8). Todos os programas e dados sao convertidos em seqUéncias de nimeros 
que sao armazenados nessa forma. 

Deve-se fornecer 0 endereco especifico de memoria para cada uma das seguintes declaracdes 
BASIC. Pode-se especificar 0 endereco com um numero, uma variavel ou uma expressao. Em qual- 
quer caso, ele deve ser calculado e referenciar um endereco de memoria real. Existem dois ende- 
recos validos para cada endereco de memoria. Um é positivo e inteiro entre 0 e 65.535. O outro 
é€ negativo e pode ser obtido subtraindo 65.536 do endereco positivo. Por exemplo, —32768 e 
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s 


32768 sdo o endereco da mesma posicado de memoria. Essa 6 uma posi¢do de memoria que o 
Integer BASIC nao pode acessar diretamente. Outra posi¢do de memoria é enderecada tanto por 
—1 quanto por 65535. Quando se recorda que o maior numero permitido no Integer BASIC é 
32767, pode-se ver a utilidade em usar numeros negativos para enderecar as posicdes de memoria 
mais altas. Se especificarmos um endereco de memoria no Applesoft com um valor real, ele sera 
convertido a um valor inteiro para ser usado como endereco. 


PEEK e POKE 


A funcdo PEEK permite ler o valor guardado em qualquer endereco da memoria do Apple II. 
Considere a seguinte declaracdo: 


10 A = PEEK (2nm) 


Esta declaracao atribui a varidvel A o valor da posi¢ao de memoria 200. 
A declaracéo POKE coloca um valor numa posicao de memoria. Por exemplo, a declaracao: 


wt PORE &000.4 


toma o valor da varidvel A e guarda na posi¢ao de memoria 8000. O valor a ser escrito na memoria 
pode ser um numero, uma varidvel ou uma expressdo com um valor final entre 0 e 255. 

Pode-se dar a declaracdo PEEK em memoria de leitura e escrita ou apenas de leitura (RAM 
ou ROM). Porém o POKE sé pode ser dado em memoria de leitura e escrita (RAM). Isso é evidente 
pois a caracteristica basica da ROM é que ela somente pode ser lida, porém nao se pode gravar 
nada nela. 


Declaracado CALL 


Pode-se transferir o controle do BASIC para uma rotina em linguagem assembler com a instrucao 
CALL. Veja este exemplo simples de declaracado CALL: 


FOO TALL at 


O controle é transferido para a posic¢do de memoria cujo endereco esta contido na variavel A1. 

A sub-rotina em linguagem assembler ou o programa pode ser um residente no Apple I! 
(ROM) ou pode ser gerado pelo usuério. O Monitor tem uma sub-rotina intrinseca que limpa a 
tela, por exemplo. O Apéndice D tem uma lista completa de sub-rotinas intrinsecas que podem ser 
uteis. O Capitulo 7 também faz referéncia com mais detalhes ao monitor e a linguagem assembler. 


HIMEM e LOMEM 


A memoria do Apple || é usada de formas diferentes. Parte dela é usada para guardar o programa 
BASIC, parte para as varidveis do programa, outra parte para os programas que mexem com drives 
de disco (se estado sendo usados) etc. Uma parte da memoria é usada para graficos, como se vera 
mais tarde no Capitulo 6. 

As declaracdes HIMEM e LOMEM permitem reservar areas de memoria para programas em 
linguagem assembler e graficos de alta resolucao. 
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Aqui esté um exemplo de cada uma destas declaracées: 


“SEP HIMEM: 38400 

1) LOMEM! Tee? 
Os limites superior e inferior s’o dados automaticamente pelo Apple I! pelas posicdes de memo- 
ria mais alta e mais baixa disponfveis ao programa BASIC pelo equipamento Apple I! particular. 
Deve-se redefinir estas posicdes no caso de se usar grafico de alta resolucao ou programas em lin- 
guagem assembler, o que sera visto em detalhes nos Capitulos 6 e 7. Para mais informac¢6des sobre 
o uso da mem6Oria, veja o Apéndice G. 


USANDO DISPOSITIVOS PERIFERICOS 


Quando se liga o Apple II, ele espera entrada de dados pelo teclado e os apresenta na tela. O tecla- 
do é o dispositivo de entrada padrdo e a tela de video é o dispositivo padrao de saida. Todavia, 
como ja é sabido, o Apple II pode se comunicar com outros dispositivos de entrada e safda. Sao 
eles: 


Gravador cassette para salvar e carregar programas (ou dados) 

Drives de disco para guardar dados e programas 

Impressora para cOpia permanente de dados e programas 

Tadbua Grafica para entrada de dados graficos desenhados a mao livre 


Comunicacdo com outros computadores. 


O gravador cassette € conectado ao Apple I! por intermédio de dois conectores especiais. 

Todos os demais dispositivos periféricos sao conectados através de circuitos eletrdnicos 
adicionais que se conectam aos slots internos do Apple II. Essas placas de circuito sao chamadas 
controladores, cart6es de interface, cartdes ou interfaces. Especifica-se que dispositivo se deseja 
usar através do numero do slot ao qual sera conectado o controlador. Existem oito slots, nume- 
rados de 0 a 7. A tela de video é sempre o slot 0. 


As Declaragdes PR# e IN# 


Para selecionar uma safda diferente usa-se a declaracdo PR#. Para uma entrada diferente usa-se o 
IN#. O exemplo sequinte em modo imediato seleta o video como sa/da: 


PR 


Se o Sistema Operacional em Disco (DOS) ndo estd presente, usa-se o PR#e o IN# da mes- 
ma forma em modo imediato e programado. Usando o PR#e 0 IN# em modo programado com o 
DOS presente é um pouco mais complicado. Deve-se usar a declaracdo PRINT que coloca o carac- 
tere CTRL-D seguido imediatamente pelo comando PR# ou IN#. As declaracdes seguintes dire- 
cionam a declaracdo da saida PRINT para o slot 1. Através da interface deste slot, a safda ira para 
uma impressora ou qualquer outro dispositivo conectado ao cartdao. 
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{00 Dé=""r REM CTRL-DB 
110 PRINT OS; "PRHI°2REM SELECTIONA SLOT 1 CIMPRESSORA) 


Sem o DOS, pode-se usar alternativamente a declarac¢ao seguinte: 
110 PR#4 oo: REM SELECTONA SLOT 1 CIMPRESSORA} 


Veja que tanto o PR# como o IN# tém um pardmetro singular cada um. Este deve ser um 
valor numérico entre 0 e 7. Qualquer outro valor causard resultados inesperados. Se nao existe 
cartaéo de interface no slot selecionado por PR# ou IN#, o Apple II trava; o Unico recurso sera 
acionar RESET. 


SAIDA DE PROGRAMA E ENTRADA DE DADOS 


Os programadores menos experientes logo descobrem que a parte de entrada e saida de um progra- 
ma é a parte mais delicada. 

Quase todo o programa usa dados que devem ser entrados pelo teclado. Serao suficientes 
as poucas declaracdes INPUT? Na maioria dos casos a resposta 6 nado. O que acontece se o ope- 
rador aciona acidentalmente a tecla errada — apds digitar dois ou trés dados? Um bom programa 
deve saber que o operador 6 humano e é provavel que cometa erros. 

Os resultados, por isso, nado podem ser simplesmente mostrados, por intermédio de um 
punhado de declaracdes PRINT. Um ser humano deverd ler a informa¢ao mostrada. A menos que a 
mensagem e o dado sejam projetados com cuidado, podera ser muito diffcil de ler e interpretar 
e, em consequéncia, pode haver mal-entendido ou confus4o total. 

Felizmente o BASIC do Apple I! tem muitas caracteristicas que permitem que se facam 
entradas e safdas corretas. Descreveremos algumas dessas caracteristicas antes de abordarmos as 
praticas de programacdo especificas para boas entradas e safdas. 


MAIS SOBRE A DECLARAGAO PRINT 


Normalmente a execucdo de uma declaracéo PRINT termina retornando o cursor para o inicio 
da préxima linha (com o carriage return). |sso faz com que a proxima declaracdo PRINT inicie 
com o primeiro caractere colocado na primeira posicao da préxima linha. Assim o programa 
seguinte apresenta uma coluna de 20 caracteres W como primeiro caractere em 20 linhas: 


> HE W 

r2O0 Cee" 

>2 10 FOR T=4 TO 20 
220 PRINT ($s 

tout) NEXY T 

2240 PRINT “FIM” 
Pew END 

> FIN 

kJ 

Ld 
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NE EEE REESE SEE LE SESE SSLSE SSE 


1M 
Usando Ponto-e-Virgula 


Um ponto-e-virgula (;) colocado depois de qualquer variavel na lista de parametros da declaracdo 
PRINT causa o aparecimento do proéximo caractere apds o Ultimo caractere mostrado. Um ponto- 
e-virgula seguindo a Ultima (ou a Gnica) varidvel na declaracao PRINT suprime o retorno a proxima 
linha. Dessa forma o programa seguinte mostrard 800 caracteres em 20 linhas de 40 colunas. 


> MEW 
2200 CH=" hy" 


>210 FOR f=7 TO BON 
>2eO PRINT CS; 

2230 NEXT I 

+240 PRINT “PIN” 
2250 END 


> RUN 


As} Usd La) Lad Lad Gal Gad Uap Le) ba) bal bad Aad Mad bad bay Aa Mad Mad bad Cad Gad Gad bd bad ad ad ba Aad Cad Ua) Led bd tad bad Ud ty 
Kad ad bad La} bal ba) Aad Mad Med bad bed Gad a Ma) Cad Wad ad Ga Aa) Cad bad ad ad Lal tad Us) Ca) add bad a) hd hd bd A 
Lab bef bad Mad Mal Lad Gad bad Lad bad bad bad Gad Usd Ud hd ad Aad ad dd hd bg A dtd td hd bd hd td ad dda) 
Lad Aad Lad La) af Lal Aad Aad Lad Lad Gad Lab had ad Usd Lad Lad Qed Lad Mad Ba) Lad bad bad Qa Cad Gad Ga) ad ad Cad Cad ad Cad hd hd a) ad 
Led La) Gab ba Lad Med Lad Aad La) bad Ca} ad Bad Ua} La) Ca) Lad ad Aad Bad ad) Bad bad bad Bad bad ad Aad Wad ad bad Led Lad bad bad bd 
Aa Aa} Rad Aad Ma) Lal Ba) Ea) La} La} Cad ha) Ua) La} Laj haf a Lad fad Nad Ca) Cad Lad Lad bed ad ad Lad Lad had od af ad Ad bad bad ha) bed a) 
Caf Caf Lab Aad Ua Lad Lad Lod hed bap Lad Laf a S21 Sb Dad Lad Lad ad bad bad Bad ad Ua) Lad ad had bad hd fh dad ad Od LT WW a 
Aa La} Ca La) Laj Lad Aa bad Us} Lad Lal Laff Bo Usd Lad bof Gad La Lad Caf Lad Caf Mad hd Bed bad had La Cad ad Led hed dd bad bg 
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As} Ua) Cad Aad Ad ba) Cad sf bad Lod Of had Cad bad bad ad hap bad ad af ad Cad Lad ad ad Cad Cad ad ad ad Usd dad ad ad dd a ad 
Lf La} La) ba) La) Caf Rad ad hal Cad bad Cad Lad Lad Lad bad haf bad Cad Cad Uo had Lad bab bad Lad Cad Cad Lad bad od ad Gd Lad Ld ad Lad Ud Ua 
Lap Aad Lad Usd Aa) bab Usd Mad haf Lad Ca ad had bad Lad Uo} ba} bad Ua bad Lad Bad Uo) Usd Lad Lad af bad af ad ad ad Lad Lad ad ad ad Lad 
Lad Lod Aa bad Lad Lab Lad Lad ad Lad Aad af Us Ad Usd Usd bod bad ad bed Cad bad Bad bad Lad Aa} Uf ad tad Ud bad ad ad ad ed La ad gd ad ad 
Lb Cad Lad Lad ad bad Cad ad bab Lad Cad bad bad Lad Ua ad bab Lad ad ad Gad Lad bad Aad gd Gad bad gd bad ad ad ad ad Lad Lad Ud Ld 
BJ bo) Lad Aad Lad bad bad ad Gad Lad Lo Lad sd baf Aad bad bed tad ad ad Rad bad bad ad ad Ga bed Aa Af ad Ca dad ad ad ad ad ad La) 
Mab Led bod bad bap Aad bad Lal bad Gad Mad bad td Lad had Lad Lad bad Lad GaP bod ad ad Mad ad a} ad ad ad ad ad ad ad ad ad ad ad ad 
Usb Lal bo) haf Ua} Usd Lad Aad Ua) Lad Wad Ua Lad Lad af bad Lad Mad Lad Us af Lad bed bad bad Us) bad ad Lad sf bad bad Lad Ladd Ud dd Ug 
Usb Lad Lad Gad ad bad Rad ad ad bad Aad hed had Ga Ab bad bad Cad Cad ad Lad Aad Ad ad bad Cad ad ad Gad Lad ad ad bad Gad Aad ad sd ad ad 
Med Mad Mad A Aad bab Cad Mad bed Lad Aad aj Ged Cad Lad bad Lad Wad AP ad Lad Uap Ad sf had Cad dad Lad Lad Cad af ad bad Gad hd ad ad ad 
Aah Uap Aub Ua) Aad bal Usd Lad Aah bad ad bad As} bad Bad bed Mad Mad ad Lad bad Lad Aad hab Gad Cad ad Lad ad Mad Cad Lad Gad ad Lad Lad ba a) ad 
Pit 

O indice do loop FOR-NEXT, a variavel |, 6 usada como contador para indicar o numero de 
W’s a ser mostrado, no caso 800. Na primeira execucao do PRINT, uma nova linha é iniciada para 
a impressao do W. O ponto-e-virgula evita o retorno para a linha seguinte, de forma que o cursor 
fica na posi¢ao seguinte ao caractere mostrado. O segundo W é mostrado a frente do primeiro e o 
cursor vai uma posicdo a frente. A seqiiéncia continua até o fim da primeira linha, quando entao o 
cursor se move para o inicio da linha seguinte. Isso se processa durante 20 linhas (de 40 colunas 
cada). 

O que imprime o FIM numa nova linha? Realmente nada; ele aparece no inicio da linha por- 
que o Ultimo W mostrado foi colocado na Ultima posi¢do da linha anterior. Troque o loop FOR- 
NEXT de 800 para 780 vezes e veja que o FIM sera4 mostrado adiante do Ultimo W. Isso pode ser 
visto adiante: 


*200 C¢="W” 

>210 FOR T=4 TO 780 
220 PRINT ¢7 

7230 NEXT I 

240 PRINT “FIM” 
2250 END 


PRLIN 


Lf a Mad ba) La) Lad Lad Lad Lad La} bab bad Lad Lad Gal Go) bod Lad Aa} Cad La} bad bod bad bad Lad ad Aa Bad Bad bad ba) ha) La) had had ad a ad 
Aa Lad Lad Qa) Lap Lad Ca) bad bad Lob sf Ash Gab Lal ab had Qa ad Aad Aad bad Led bel bod bod Lad Lad Aad a Aad Ra Rad bad bad Led had bd ad a 
Lod As) Usb bol bab Lal Lab bab bad bad ba) bad ba) Lad Lad bop Cap Cad Co a tad tad ad Lad La hod od Lad a tad bad ad Lad ad a had bho of 
Lad La) Lad bof bal Gad oy bap Lad Lab had haf Lb Lad bad bo} sf od fa) Bap Caf bad ad La) La) Lad bod Lad tad bad Gad be ab ad bad ha) a La 
Aad Lad bal Lo) Had Laf Lab Lap taf Ua) Lol Lab Led Lad a fed Lal hal ad Lol bg} Lal Esl bed bod bad La} bab Sad Ua) bal hy Cad ha) a bad af hd ad 
Us Esp LaJ ad Ua) bed ba} a Bod ba) bad Lf Bad Cob bof Cad Lad bad ad Mad Cab balay bed a Aad Wad ed tad ad ad hd bad a Ua) ba) hd Ld 
Ls) Es) Lab Lab Mal Qa Lad Ea) Lad La} bab bad od bed Lad Ga} Gad ba Aad Cad bad Lo) fad bad bo) bad bof Lad bad bad ad bad bd bad bad had hg ad 
Mad La Cad Asp La) La) bad Lad Qs) Gad bed ba} bad gd ab Asad Bad Ua Rad Cad Cod be) ba) ad bad Gad fa Lad Bad Sad bad ad had bd Uf bd bg bY 
As) Qa) Ga) La) bal a bad bab Auf Cad Lad Aad Gab ad Cad ad ad Lad bb) Ged aad Lad ad ad Cad Bad Lad ad add ad ad a ad 
Le} La bad Lab Lab bad La Bad ba} Ua} Uf sf sf ad Cad Ca} Cad Gad Lad Lad Ca} bad hed Aad Bad bad Lad hob ad La ad ad bed Lal ad ba) a) bad ad 
Lod Bs) ba) Qu Bad bab haf Aad Ua) had a} Aad Lad had Af Usd Ua) Gad Aad Bad ad Ad bad bcd bo Bad bad a add ad A ad badd Ua) ad Bad bY 
Aad Auf As) ba} Uad Us} Lad Lap La} la) Ua} Laff sf Lad had Aad Ua fad Usd Cad bad Lad bed Lad Qa) af dd Bed ad ad bad a) ad bd bd hd dd 
Aa Esp Usd Aa) bad La} bab bab Ged Ga} bap Aad Ad a bod Bad bad Gad Cad Lad God ad Qo gd ad ad bad ad Lad Led bod sd ad Od dd bad ed 
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Aa) Lad Lad dod Sad Aad Lad bad had Lad Us ad af a} bad bad Lad bad hd af Gad Gad bad bad dd hd ad ad bad bad bad Ga gd bad ad Lad bad bad 
AJ Lad Lad bad bal Ua Wa ba Lal Mad Lab ad GaP ed tad ad Led Sa Ad Ae et bad Lad La ad Led Lad ad Ua ad bad ad ad ed Ud Ld 
Mad Lad Lod Had Gal Lad Lad Mad Ac} bad Caf ad hed bad bad bad bed Led dad ad Gad bad Cad ad Lad ad Ua dad ad bad ad ad id hd ad a 
Aad sd Lad EJ Og} Usd Usd bs) Lad bad bad dod ded Ged Lad dad Bl had af bad bad bad ed ad ad Lad Lod Lad bed bed bad Od Aad af Lad Cd bad gd sf bad 
Ua} Bad bad Lad Lad Gad Aad Lad bad bad Aad Lad bed tad bad ad Lad Uf had bod bad ba had Od bod dd bed bo id bd ad Bs ad ba bad bad dad ts} had 
Lad Ls Mad Lal tad Lad Lab Lad bod Cad Lad Lad bad Af bad od Led bad ad Lad Lad UP bad fd bod bad bd had Lad ad hed ba hed a gd bed dd bad 
Lo bad bed bad Lad bd dad iad dg) bad dd ba a bod ad ed a edd QOD 


O ponto-e-virgula concatena corddes de dados mostrando itens, um atraés do outro, sem 
espacos entre eles. Dados numéricos também sao mostrados em formato de linha continua, sem 
espacos entre valores contiguos. 

Para ver isso, troque o valor da varidvel para um nUmero de apenas um digito. O programa 
sera assim: 


+200 C=5 

2270 FOR T=1 TO 800 
»220 PRINT C3 

reac NEXT [| 

2240 PRINT “FIM” 
2200 END 


O nimero 5 é mostrado como segue: 
7 RIN 
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Badd ae SY Checked weed aoe CE eT ad ae cd cb od ad ed vcd ccd cd acd ad sob sad red dee at 


Ge: (oe peg Rye RR EE a a es ee SES ee ey ey ee Ee ae Sc 
CEs ds dialed dadslgdadsisdedadeled sad sda) led sladated cist red ted 0 


Se ey ey es re od Rd eek ok Eh heh ee eed ed ed hd CE eh eas 
nob cd eed sab Pd ed tad eb ve tad ed ed ned ted ted ad ed el ed nad Ge ad we nab ted ed Aad Sak tod tad Seb ved ned eb OS 


gy a5 Rs SSS Sy AS Me Ae ee Oe ee 5 Sp Be, Bes 
edstebstsdciake Fred tod ned ed ad cad ted ® Bob ed Ned Sed ried ted teed Ned tod ed Sed rad Posse wed ads 


Co €3° te os £ Br ee Ge ES Fe ee ee Be ee oe a SS Se eS Ss 
Sicdaded edhe fhe ee er we ee ind tad ed nd nad nbd ad ted ad ny eb raed cds oN Sc 


na ail uaa Be poe ew dei tr Waa Bas’ Bad ba BA Pes ow ake spk Tees BS es es tae ewe se Bee Bn Bt ws a Pee pe 
ab Wd ded dad vd ad ud ube. tad ad id ed ead ne nb stad ne ted ted ted ne PSdsd ads. a a 


Gs. O° 6S" Co: Go. Gee E* Kee Ese Gs" £:° Es: Zoe ee Se eo ee Se eee Se ee 
sad nad * ISOS: Aside ise J adnds wb nab vd ned ad © sed ad wed nd ne Dd nd sid ss tet iad aedal ted web oa 


°c 0 eS Sicha ietaha bbw be op Ry ay es a, Be se Ey Be) eS ee sO Ge Gey es 
Sistas Jad wd cd we sed ad ne ads ed ad Me Sudedtad wd sdadadadad dad ada 


By, 62° 6s fo fy £c° €2* fe Se eee ee ee ee ea ees iach l ed Cee bed cde hat ol 
Cc hcicdalciolciclchaie wed ads Ea ed od ied wd wk ad ad tod tad tad tad ted he wd wb ved ad 


iy sy Ss ay Wy ay Ws Me a A ae AS ae ee a eS a a SS eS a a ee ee 
Soe abe cr Cs wi dad deb ed ad cd ab BD ab be a bed ada ad ted Sed ed ted ted tad ad de, 


o 2°. Bs? Biss ee ge eS ee eS eS eS Sass 
at a apes al ba ab web ndind s winds, nad tad Aad wb ad ad Nae fet % tad tad ed tad ne Lad ads ad ab ae ued wed % ead Sed 


BE ee ee oS Be) Es) Re Ee Gs) Be) be eee eee See ees, oe eee Ss 
rod ed Sic ted ted ed ad tad TOSS ch obec Jadndad. Dad ed ad dd ad aed ee at ee dad ad 


* s° Bos io Roe ee €:° Bs° es? &s° Es" Be hace ta Ze" tad a aa foag ben Tees ea esl ed Doe’ Se eee Se Se SS 
Pi cdess bad Shs SC cheseae Fad at ds. ” dined’: ws. < Mad Meet ed ad te 


wi ae ova tate ea ew ope oe SOR Ree See GE ReT eas meee ence cere 
dud ned od eC okedch ded whe wd tad ted vat ted Me ted *e Badd dB eS weudn. at wad n.d 


£30 2° Bo tise ise bee ese se ey ee es" BS) ES yr AS) Bt ty 2) es) er et ety es) sy ey ete aerate RD ee eS, ED et an ee 
wb 4d ud ved Dana cd led sd wisdaa bal bai be gee bol ewe bo ee fee ep bad datad deeds dadsd 


sal bes baal ba test ews da oa has ew EE ee SSS SS eS eS SSS Seas 


® 


Fed ak al tat ad ed tak tad vad peal bad wb ned wd sub nd bed ad nad oid eo ed ed aed ed at ad al 


FC hehe) ied clea eed 
se 


og SS ny eS SY tT ey sy 


Pl Stn ats Ps eb ad seb wd web dd cd Ld CD PD 


ran 


> 





(Ne eo Chl od ol ed eee oe 
SF DEE SDSS 52 2 SS Gs SS eS ES 


cc &; 
i am 
5 Bip BS, iy Fe ee et ee ss a Ce Bs ni 
Meee aS fad 


PROGRAMACAO BASIC AVANCADA 


Agora troque o valor de C por —1: 


4 
Me T=47 TO 
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{oe 


r2Q0Q0 


e 
ra 

> 
fhe 


800 


3 


10 F 
reeO PRINT 


*230 NEXT T 
2240 PRINT 


r2u0 
> RUN 


> 
t, F 
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O que aconteceu aqui? Quando C é —1, o programa mostra duas vezes mais linhas do que 
quando C=5. Usa-se uma posicao extra na tela para mostrar o sinal de menos. 

Numeros de miultiplos digitos (incluindo negativos) vao estourar a capacidade da tela, a 
menos que o loop FOR-NEXT seja ajustado. Se o C for trocado por 2001, um campo de quatro 
digitos sera requerido, de forma que devemos ajustar o indice de 800 para 800/4=200: 


200 C=2001 

210 FOR T=1 TO 200 
220 PRINT C3 

>230 NEXT I 

>24&Q PRINT “FIM” 
250 END 

> RAIN 


200420072001 20017 2004 200120017 20072001 2001 
2007200172007 2007 20041 20072004 200720072004 
200120014 200172007 2001 200172007 2007 20072001 
200720012001 20017 200120072007 2007 20072001 
200420042007 2004 2007 20047 2007 20072007 2004 
2004120012004 200720047 20072001 20072007 2004 
2007200720017 200172007 20072007 2007 2004 2004 
200720012001 20012001 2007 2007 200720072001 
2007200712007 2007 2001720072007 2001 200720014 
2007200420047 20041 2007200172007 2007 2007 2004 
200420072004 20072001 20072007 2007 20072001 
2007200172004 200172001 20072007 20072007 2004 
2001720072007 20072004 2001720097 20072001 2004 
2004200172001 200120012007 2007 2001 20072001 
20012001 2004 2007 200120012001 20072001 2001 
200120012004 290012001 20017 2007 200120072001 
200120012001 2007 2007 2007 20072007 200172001 
200120072001 20012004 200172007 2001 20072001 
200120012004 20012001 20072004 2001720072001 
200120012001 20012001 2001200172001 20072001 
FIM 


Os nuimeros sao cortados no fim da linha, se necessdrio. Isso 6 porque o ponto-e-virgula ( ; ) 
sera continua apresentacdo, e nada além do fim de linha pode causar um retorno. Tente o exemplo 
acima com C igual a 201 para ver isso. 
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Usando Virgulas 


O aparecimento de virgulas entre varidveis ou no fim de uma declaracdo PRINT trata os dados 
mostrados como se eles estivessem tabelados em intervalos especificos. As regras de tabulacao sao 
diferentes no Integer BASIC e no Applesoft. 

O Integer BASIC tem cinco paradas de tabulacdo na tela. Sao as colunas 1, 9, 17, 25 e 33; 
existem 8 espacos entre cada uma. Aqui esta um exemplo: 


NEW 

> 200 C=4123 

- 210 FOR T=1 To 100 
>) 220 PRINT C. 

> 280 NEXT 1 

> 240 PRINT “FIM 

» 280 END 

> RLIN 


123 123 123 423 42: 
423 123 123 123 123 
123 123 123 123 123 
123 123 129 123 123 
123 123 123 123 123 
124 123 123 123 123 
123 123 123 23 123 
123 123 23 123 123 
122 123 123 123 123 
123 123 22 23 123 
123 123 123 23 123 
129 123 123 123 123 
123 123 123 123 123 
123 123 123 123 123 
123 123 123 23 123 
123 123 123 123 123 
123 123 123 123 123 
123 123 123 123 123 
123 123 123 123 123 
123 123 123 13s 123 
Py 


Deve haver pelo menos um espaco em branco 4a frente da posicdo de tabulacao (a excecado 
da primeira) ou a posicao de tabulacdo ficara inativa. Assim, nado deve haver nada colocado na 
coluna 8 para que a segunda posicao de tabulacao seja ativa, e assim por diante. O programa 
seguinte ilustra isso com cord6es de texto: 
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“10 REM DEVE-SE DIMENSIONAR AS VARTAVELS CORDAC 


*20 DIM C#¢8) 

220 Ce="42945678" 
P2100 FOR T=1 TO 2 
L207 PRINT (4, 
Peon MEAT | 

29240 PRINT “FIM” 
2250 END 

> RUN 


12345678 12345678 12349478 
123454678 12345678 
12945679 (2345472 T2S345678 
12345678 T2345678 
123945678 F2S4547R T2345678 
12345678 12345678 
T2S4567E2 12345678 12345678 
T2945678 T2345678 


FIM 


Se trocarmos o C$ por ‘’1234567", todas as cinco posicdes de tabulacdo serdo usadas. 


Existem algumas condi¢des especiais que governam a tabulacdo com virgula no Applesoft, 


como mostrado na Figura 4.1. 


a Posics x fn i 
18 Posicao de Tabulacdo 2° Posigao de Tabulagao 32 Posicdo de Tabulacdo 
© S6 existe se nao existir nada_» s6 existe se nao existir nada 
colocado na coluna 16 colocado nas colunas 24-32 
@ Infcio na coluna 17 ® Inicio na coluna 33 


® Inicio na coluna 1 


_ largura de 
largura de 16 essay largura de 16 espacos 8 espacos 





FIGURA 4.1. Paradas de Tabulacdo do PRINT no Applesoft. 


Para ver como as virgulas funcionam no Applesoft, usando nosso programa de exemplo, 
troque o ponto-e-virgula da declaracado PRINT por virgula. Isso causa a colocacdo dos numeros em 
trés colunas. Com trés nimeros por linha, o indice do loop FOR-NEXT sera 3*20=60. O progra- 


ma completo é mostrado a seguir. 


1200 C = 2004 

JeiG FOR f = 7 TO 60 
aeeQ PRINT C, 

J230 NEXT I 


3240 
J250 
RUN 


2004 
200 
2004 
2004 
2004 
2004 
2004 
2004 
200) 4 
2001 
2004 
2004 
2O4 
2004 
2004 
yt 
out 
2004 
2004 
2004 
Fy M 
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PRINT “PIM” 
END 


2 O04 
eo 
2004 
2001 
OO 
ZOO 
“O01 
ZOO 
2001 
2001 
2QO1 
2001 
2001 
2004 
e001 
ZOO 
2 OL) 4 
ZOO 
20014 
2004 


2O()1 
20014 
2004 
me OC) 4 
201 
2001 
ZOO 
“O01 
2001 
aQO7 
2004 
2001 
2001 
2001 
2004 
2004 
VC) 1 
ZOO 4 
et) 
2004 
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As virgulas também funcionam com corddes. Como exemplo, coloque o seguinte programa 
para mostrar vinte linhas de caracteres alinhados: 


NEW 
1100 
1140 
1120 
1210 
230 
1240 
I200 
JRLIN 


TERRA 
TERRA 
TERRA 
TERRA 
TERRA 
TERRA 


T Bf Fe fy 


Aéee TE RR A” 
Bee“ AGUA” 
O$="UTDA" 

FOR T=1 TO 20 


PRINT AS-BS,08 


NEXT 1 
PRINT “FIM 
END 


AIUA 
AGL 
AGLI 
ASL FY 
AGL 
AGUA 
AGL 


VIDA 
WIBA 
VIDA 
VIDA 
WE DA 
WIDA 
VIDA 
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TERRA AGLI A WIDA 
TERRA AGUA VIDA 
TERE A AGUA WIDA 
TERRA AGUA WIDA 
TERRA ALA WT DA 
TERRA ALF WDA 
TERRA AGUA WT DA 
TERR A AGUA WIDA 
TERRA ALS LIA WDA 
TER Fe A ALLA VIDA 
TERRA AGUA VIDA 
TERRA ALU A WIDA 
TERR 4 re VTA 
Pin 


Como exercicio, tente colocar B$ como ATRIBUTOS no lugar de AGUA. Se for visto na 
Figura 4.1, ndo haverd surpresa ao se ver que a terceira posi¢ao de tabulacdo nao sera usada. A 
palavra ATRIBUTOS, iniciando na segunda posicdo de tabulacao na coluna 17, mostra dados nas 
colunas de 24 até 32. Colocando qualquer coisa nas colunas 24 a 32 desativa a terceira posi¢ao de 
tabulacao. 


FUNCOES DE FORMATAGAQ DE IMPRESSAO 


Usa-se a palavra formatacao para descrever o processo de arranjar a informacdo na tela de video 
de forma que ela seja mais facil de ser lida e entendida, e mais agradavel para a vista. Como se viu, 
os sinais de virgula e ponto-e-virgula ajudam. A formatacado pode ainda ser uma tarefa desafiante. 
Por exemplo, suponha que se quer mostrar um cabe¢alho no meio da primeira linha no alto da tela. 

Aqui esta um programa em Integer BASIC que usa virgulas para tabular no centro da telae 
imprimir o cabecalho. Também é usada a declaracdo CALL, recentemente estudada, para posi- 
cionar o cursor no canto esquerdo do alto da tela (veja Apéndice D). 


> NEW 

+S REM DEVE-SE DIMENSTONAR CORDOES 
>10 DIM HD$¢ 30) 

*500 REM LIMPAR A TELA E 

»S10 REM MOVER O CURSOR PARA 

9520 REM O CANTO SUPERTOR ESQUERDO 
2330 CALL —?.s6 

1540 HD$="RELATORTO* 

2550 REM TABULA NO CENTRO DA TELA 
Jon REM E IMPRIME © CABECALHO 
ra6Q PRINT “2 *" »HDS 

2370 END 

> RALIN 


RELATOR TO 


PROGRAMAGAO BASIC AVANCADA 115 


O cabecalho ficou aproximadamente centrado na tela. Se ele for mais extenso, por exemplo 
RELATORIO PARCIAL DE AGOSTO, poderia nao ficar centrado. (Tente.) Este novo cabecalho 
sera aproximadamente centrado quando se remover uma das virgulas e cordao nulo correspon- 
dente, de forma que o corddo é colocado a partir da segunda posicao de tabula¢ao no lugar da 
terceira. 

Pode-se usar a mesma técnica para mostrar cabecalhos no Applesoft. Porém o Applesoft tem 
recursos de formatacdo da declaracado PRINT mais faceis de usar: as funcdes SPC, TAB e POS. 


A Fungao SPC 


A funcao SPC salta espacos. Inclui-se o SPC como um dos termos da declaracao PRINT; apos as 
letras SPC deve-se incluir (entre parénteses) o nUmero de posi¢des que se deseja pular. Por exem- 
plo, pode-se centralizar o cabecalho RELATORIO com o seguinte: 


4100 REM CIMPA A TELA 

34490 HOME 

4720 REM PULA ESPACOS EF DA MENSAGEM 
4780 PRINT SPOCTD 2s "RELATOR LO” 

4140 END 

JRUN 


RELATOR TO 


Veja o ponto-e-virgula apos o SPC. Uma virgula faria iniciar a apresentagdo do texto na préxima 
posi¢ao de tabulacao seguinte ao numero de espacos especificados pelo SPC. 

Sempre que se inclui a funcao SPC numa declaracado PRINT, simplesmente faz-se com que o 
proximo caractere a ser colocado no video apareca deslocado do numero de posicGes especificado 
pelo SPC, em relagdo ao local em que originariamente apareceria; nada mais acontece. 


A Funcgao TAB 


A fun¢cao TAB opera de forma muito semelhante ao que acontece com a tabulacdo de uma ma- 
quina de escrever. 


Numero de Coluna 











FIGURA 4.2. Determinando a Posicaéo de Caracteres na Tela. 
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Suponha que se deseja colocar dados em colunas. Deve-se, em primeiro lugar, calcular a 
posicao em que cada niimero deve comecgar. Um formuldrio como o mostrado no Apéndice L é Util 
para esse proposito. Na Figura 4.2, as colunas iniciam nas posi¢des 1, 15 e 31. Agora, ao invés 
de se usar espacos em branco como se faz para ir de coluna a coluna, usa-se a fun¢ao TAB apés 
cada entrada na declaracado PRINT. 

Considere a linha mostrada na Figura 4.2. Contando posicd6es de caracteres, poderfamos 
apresentar a linha sem paradas de tabulag¢ao, como segue: 


210 ?°PEDROSO, J. et meres PF 1420,00" 
Ao invés de se colocar espacos em branco, pode-se usar a funcao SPC e diminuir a declaracao, 
como aqui: 

10 ?P*PEDROSO, JI.M3SPC(7)3°431- mite fF 3 Se 

Cts 4420, Oo” 


Mas tabular é mais facil porque se tabula para um numero de coluna conhecido ao invés de contar 
espacos: 


110 ?”°PEDROSO, J.M” 2 TABC16)3°%434-25-6277"° 5T 
AB C32)3°1420.00" 


Determinando a Posicéo do Cursor (Horizontal) 


POS é a Ultima das funcdes de formatacao do Applesoft. Ela mostra em que posi¢ao o cursor se 

encontra. Essa posicao é expressa como um numero, que é o numero da coluna em que o cursor 

se encontra piscando. Sempre se inclui o argumento inutil (0) depois do POS, como segue: POS(0). 
O seguinte comando demonstra a capacidade do POS: 


TO"“POSTCAQ DO CURSOR =" sROS¢D) 
Execute este comando de modo imediato. Na tela aparecera o seguinte: 


1?”"POSICAGO DO CURSOR =*7POSCO>) 
POSICAO DO CURSOR =19 


O cursor estava na posicdo 19 apds colocar POSICAO DO CURSOR =. Se forem colocados alguns 
espacos apds o “’="", e antes do fechamento das aspas, troca-se o numero 19 por algum numero 
mais alto. 

No Integer BASIC pode-se simular o POS(0) com um PEEK(36) para determinar em que 
coluna o cursor se encontra. Aqui esta o exemplo anterior reformulado: 


SPRINT “POSICAO BO CURSOR =" FEREK C34) 
POSICAQ BO CURSOR =19? 
Note que as colunas da tela sfo numeradas de 0 a 39 para POS, PEEK(36) e SPC. Elas sao nume- 


radas de 0 a 40 para a funcdo PRINT TAB e para outras duas instru¢des que veremos mais tarde, 
HTAB e TAB (Integer BASIC). 
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Determinando a Posicao do Cursor (Vertical) 


Um PEEK(37) da a posicado da linha em que o cursor se encontra. 
As linhas sdo numeradas de 0 a 23 para o PEEK(37), mas de 1 a 24 para o VTAB (visto na 
proxima secao). 


CONTROLE DE CURSOR E EFEITOS ESPECIAIS DE VIDEO 


Existem algumas declaracdes em BASIC que aumentam a versatilidade do video do Apple II. Sao 
elas as declaracdes FLASH, INVERSE, SPEED, NORMAL, HOME, VTAB e HTAB/TAB. A maior 
parte destas estao disponiveis apenas no Applesoft. Existem também algumas fungoes grdaficas; 
sao estudadas no Capitulo 6. 


Posicionando o Cursor 


J& vimos varias formas de controlar o cursor através do uso de virgula e ponto-e-virgula com a 
declaracgdéo PRINT. As funcdes de formatacéo SPC, TAB e POS do Applesoft também sao Uteis 
para posicionar o cursor. 


Limpando a Tela do Video 


Pode-se limpar a tela e posicionar o cursor no alto 4 esquerda com a declaracao CALL-936, ou 
com a declaracdo HOME no Applesoft. Tente digitd-los (um para o Integer BASIC, 0 outro para 
o Applesoft): 


CALL =9Sé6 


THOME 


Posicionamento Horizontal e Vertical 


Existem duas declaracdes que em conjunto permitem mover o cursor para qualquer posi¢ao na 
tela. VTAB move o cursor verticalmente e HTAB (TAB no Integer BASIC) move o cursor hori- 
zontalmente. Deve-se especificar o numero da linha para VTAB e 0 numero da coluna para HTAB. 
A linha mais alta da tela é 1 e a mais baixa 24. A coluna mais a esquerda é a de numero 1 e a mais 
a direita é a 40. 

O programa seguinte usa estas duas declaracdes (no Applesoft) para posicionar o cursor em 
mostrar um asterisco naquela posicao. No caso do Integer BASIC use TAB ao invés do HTAB nas 
linhas 90 e 120. 


PO HTAB TEUTAB C7) 
100 INPUT “LINHA?T? +L 
T1O INPUT “COLUNA?T*>C 
T20 YVTAB Le HTAE C 
120 PRINT “x”; 

140 GOTO #0 
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As Declaragdes INVERSE e NORMAL 


Pode-se inverter as partes branca e preta do caractere na tela; a declaracdo faz isso. Uma vez que a 
declaracado 6 executada, tudo que for colocado na tela pelo PRINT aparece no modo video reverso. 
Os caracteres que sdo digitados no teclado, no entanto, s4o passados para o video em modo nor- 
mal. 

O Apple II retorna ao modo normal quando for executado 0 comando NORMAL. 


Para ver como estes dois comandos operam, tente isso (os caracteres sombreados sao em 
video reverso): 


JINVERSE 

J7°PRETO NO BRANCG® 
PRETO NO BRANCO 
ANGR MAL 

JE" BRANCO NO PRETO" 
BRANCO NO PRETO 


O INVERSO e 0 NORMAL no sao aceitos pelo Integer BASIC. 


A Declaragao FLASH 


Além de se poder reverter as partes branca e preta do caractere, pode-se ainda fazer com que ele 
fique piscando entre os modos normal e inverso. Use a declaracdo FLASH para isso. De novo, o 
NORMAL faz 0 Apple I! retornar ao modo normal. 

Aqui esta um exemplo (a drea sombreada fica piscando): 


JFLASH 

a? °CARACTERES PISCANDO” 
CARACTERES PISCANDO 
JNOR MAL 

J? °CARACTERES NORMATS * 
CARACTERES NORMATS 


O FLASH ndo é permitido no Integer BASIC. 


A Declaracao SPEED 


A velocidade com que os caracteres séo mostrados no video é variavel. Pode-se diminu/-la da sua 
velocidade normal através da declaracdo SPEED. 
O programa seguinte ilustra como o SPEED funciona: 


1100 INPUT “VELOCTDADE* 2 VL 
4440 SPEED = VL 

te FOR GT = 1 TO 3 

2140 PRINT *VEL” 

I140 NEXT 

2150 PRINT “FIMVEL” 

J160 SPEED = 25S 

1170 END 
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O valor da expressdo (isto 6, o valor de VL na linha 110) ajusta a velocidade de impressao; 
0 é a menor e 2556 a maior. O SPEED também afeta a velocidade com que os caracteres sao man- 
dados para outros dispositivos, ndo apenas para a tela. 

O SPEED néo é permitido no Integer BASIC. 


JANELAS DE TEXTO 


Normalmente, o Apple I! utiliza todas as 24 linhas e 40 colunas da tela no modo texto. Usando a 
declaracdo POKE, pode-se alterar o tamanho e a posicdo dessa jane/a de texto. Quatro posicdes de 


memoria controlam o tamanho, a forma e a posicao da janela de texto, como mostrado na Ta- 
bela 4.1. 


TABELA 4.1. Posicdes de Memoria da Janela de Texto. 


a2 0a 39 
33 1 a 40 menos Margem Esquerda 
34 O até Linha de Baixo 

35 Linha de Cima menos 24 












Margem Esquerda 











Largura 
Linha de Cima 
Linha de Baixo 









Deve-se ter cuidado em observar o bom senso nos limites de faixa descritos na Tabela 4.1, 
quando se determina a janela de texto. Tentar determinar janelas fora desses limites dara resultados 
imprevisiveis. 

O exemplo de programa abaixo serd uma janela de texto de duas linhas no meio da tela para 
entrar um valor numérico. Para apreciar toda a utilidade da técnica, tente entrar algum valor nao 
numérico e observe o que acontece com a mensagem de erro. Note também que em se determi- 
nando a janela de texto, ndo se apaga o resto da tela, nem se move o cursor para dentro da janela. 
Deve-se dar instrucdes especiais dentro do BASIC para fazer essas tarefas. 
qano PEM BETERMINA LINHA DE CIMA DA 
J@HELA-MARGEM ES @UERDA E LINHA DE BATXO 
{O10 Ts (DsWe2OilMe tte 
1020 REM LIMPA A TELA 
1030 CALL “P26 
4940 REM DETERMINA A JANELA 
Paka EM TR ADA 
4050 HOSUR S200 
$940 REM LIMITA A JANELA DE TEXTO COM 
ASTER TSCOS | 


TO? GOSUR B00 


oy 


on 


nny 
vee 
ert 


TEXTO 


120 APPLE II 


4080 REM MOVE CURSOR PARA DENTRO DA 
JANELA 3 ENTRA 

4090 VTAB T+2 

4400 INPUT M1 

4410 REM ELIMINA JANELA ~ VIDEO INTEIRO 
4120 GOSUB 3300 

4130 REM MOVE CURSOR.LINHA DE BAIXO 
4140 VTAB 23 

4450 END 

2990 REM  LIMITANDO A  JANELA OM 
ASTERISCOS 

2000 VTAB T+4 

3010 GOSUB 3400 

32020 VTAB B+1 

3030 GOSUB 34100 

3040 RETURN 

3090 REM COLOCA ASTERISCOS 

3400 FOR I=4 TO W 

3410 PRINT “x” ’ 

3420 NEXT T / 

3430 RETURN 

3190 REM CRIA JANELA DE TEXTO 

3200 POKE 32,T 

2210 POKE 33,W 

3220 POKE 24,LM 

3230 POKE 35,8 

3240 RETURN 

3290 REM GERA JANELA INTEIRA 

3300 POKE 22/0 

3310 POKE 33,40 

3320 POKE 34,0 

3330 POKE 25,24 

3340 RETURN 


A FUNCAO CHR$: PROGRAMANDO CARACTERES EM ASCII 


No capitulo anterior vimos como se pode gerar caracteres invisiveis como o CTRL-G, que da o 
bip. Porém existem certos caracteres (tanto visiveis quanto invisiveis) que nado podem ser digita- 
dos diretamente pelo teclado, incluindo ‘’]’’ e ‘“\"’. Pode-se gerar estes caracteres no Applesoft 
com a funcdo CHR$. 

Para entender como a funcdo CHR$ opera, deve-se entender como o Apple I! guarda os 
caracteres na memoria. Na verdade é bem simples. A meméoria do computador pode armazenar 
numeros, mas nao caracteres. Os caracteres devem ser convertidos para cédigos numéricos. O 
Apple Il usa o mesmo cédigo que todos os outros microcomputadores, o ASCII (American Stan- 
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dard Code for Information Interchange). Por exemplo, o cddigo ASCII para a letra A é 65, para 
B é 66, C é 67 e etc. Existe uma tabela completa do cédigo ASCII no Apéndice |. Sempre que o 
Apple I! estiver operando com cordao, ele interpreta valores numéricos como cédigos ASCII para 
caracteres. 

No Applesoft, se ndo é possivel acionar uma tecla para incluir um caractere dentro de um 
cordao de texto, pode-se ainda selecionar o caractere usando seu cddigo ASCII. 

A funcdo CHR§$ traduz o cédigo numérico em ASCII no caractere equivalente. Por exemplo, 
para criar o simbolo ‘’$’, primeiro ache o seu cddigo ASCII no Apéndice |. Daf use 0 codigo com 
CHR$ como segue: 


JPRINT CHRE(36) 
¢ 


Experimente em modo imediato usando qualquer cédigo ASCII entre 0 e 255. 
Pode-se usar a funcdo CHR$ em conjunto com cord6es regulares na declaracdo PRINT, 
como segue: 


JPCHRS(34)3“ASPAS! “3 CHRE C34) 
“ASP AS 1" 


A funcéo CHR$ permite incluir caracteres que de outra forma nado seriam permitidos, tal 
como retorno e aspas, como parte do cordao de texto. 


PROGRAMANDO ENTRADA DE DADOS 


O objetivo de qualquer programa é minimizar erros na entrada de dados e tornar facil para o ope- 
rador o ato de corrigir erros, caso ocorrerem. Existem formas de organizar os dados de entrada de 
forma a minimizar a ocorréncia de erros. 

Primeiro, entre todos os dados de um bloco e depois processe-os. Nao é uma boa pratica 
processar cada dado assim que ele é digitado pelo teclado. 

Um programa de mala direta, por exemplo, requer nomes e enderecos a serem digitados co- 
mo dados. E interessante que o bloco nome-e-endereco seja tratado como um Unico bloco de 
dados. Em outras palavras, o programa deve pedir nome e endereco, permitindo ao operador entrar 
toda a informacdao, e ainda poder alterd-la. Quando o operador tiver certeza que nome e endereco 
estado corretos, 0 programa podera seguir adiante e processar essa informacdao. Apds isso devera 
parar e esperar por outro nome e endereco. 

No caso do programa de mala direta seria uma pratica ruim pedir o nome, processa-lo imedia- 
tamente, pedir cada linha de endereco, tratar cada pedaco do nome e do endereco como unidades 
separadas com funcoes distintas. 

E sempre uma boa idéia organizar a entrada de dados de forma que eles permanecam no 
video por algum tempo apos as suas digitacdes. Isso faz com que seja dado oportunidade ao ope- 
rador para reparar erros e corrigi-los. Se os dados entrados desaparecem tdo logo sdo entrados, nao 
ha oportunidade para que o operador reveja a digitag¢do e ocasionalmente detecte um erro. Natural- 
mente o operador deve ter alguma forma de corrigir digitagOes prévias. 

Em alguns casos, nao é bom deixar o operador digitar os dados em blocos funcionais e ter 
possibilidade de corrigir erros. O nUmero de vezes em que isso acontece é bem grande. Ocorre 
quando um grande volume de dados deve ser digitado pelo operador. Por exemplo, suponha que 
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um operador de teclado deva digitar centenas de nomes e enderecos durante o dia. A experiéncia 
tem mostrado que um volume de digita¢ao mais correto é obtido quando o operador ignora os 
erros de digitagdo na primeira vez que digita. O programa de entrada de dados neste caso nao per- 
mite que sejam feitas correcdes na primeira digitag¢do, mesmo que o operador perceba o engano. 
O digitador deve ignorar o erro e seguir adiante colocando os dados o mais rapidamente possivel. 
Sob este esquema, os dados sdo digitados duas vezes, de preferéncia por operadores diferentes. 
As chances de que os dois operadores cometam o mesmo erro é tao pequena que se pode contar 
todos os erros achados com as diferencas entre as duas digitag¢des. Um programa subsequente 
permite a reentrada dos dados colocados incorretamente. 


Entrada de Dados Interativa 


Um programa com entrada de dados interativa guia o operador com mensagens e indicacdes no 
video. Para demonstrar a entrada de dados interativa vamos colocar um exemplo bem simples. 
Faremos uma modificagao num programa ja visto neste capitulo de forma que ele usard o processo 
interativo de entrada de dados, tornando assim o programa mais facil de usar. 

Aqui esta 0 programa: 


200 CC = “W" 

210 FOR I = 1 TO 8O0 
me PRINT (4; 

eoQ NEXT I 

24Q PRINT “FIM” 

2euQ END 


Como foi mostrado, o programa coloca 800 caracteres W seguidos da palavra FIM. Ele opera 
da mesma forma tanto em Integer BASIC quanto em Applesoft. 

Suponha que desejamos trocar o W por qualquer caractere. 

Primeiro eliminamos a declaragdo de determinacao do programa. Lembre-se de que para 
eliminar uma declaracao do programa, digita-se o nimero da linha seguido pela tecla RETURN. 


210 FOR [ = 7 T9 800 
220 PRINT C& 
2ou NEXT I 
240 PRINT *FIM 
av END 
A linha 200 nao esta mais no programa. 
Digite CS=“X"’ em modo imediato, e execute o programa. 


JO ee XK 
JRUN 
FoM 
A palavra FIM foi colocada mas os X’s nado. Claramente o valor de C$ nao foi transferido 


para O programa. 
O comando RUN coloca todas as variaveis numéricas em 0 e todos os cord6es em nulo antes 
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de iniciar a execucdo do programa. Entdo o C$ foi colocado em nulo, e o loop mostrou no video o 


s 


Caractere nulo (um nulo é “nada”, nado transfere o caractere para o video nem move o cursor). 

Existe uma forma de transmitir um valor diferente de C$ a cada vez que se roda o programa? 
Ao invés do RUN que limpa as varidveis, use GOTO 210 (sendo 210 a primeira linha do programa). 
Isso nao modifica nenhuma variavel. 


IC$="X" 


IGATO 210 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXX XXX X 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXXXXKXXKXXXK 
XXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXKXAKKXXXXXXXKKX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXXXK 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXKXKXXXXXXXKKXKX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXKXKXXXKXKXXXKKXK 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXKXX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXXKXKXX 
XXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXXXXXXKXK 
XXXXXXXXXXXXXXXXXXXXKXXXXXXXKXXXXXXXXKXXKX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXKXXXXXXXXXXKXXNXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXKXXXXXXX 
XXXXXXXXXXXXXXXXXXXXXKXKXXXXXKXXXKXKXXXKXAXXXX 
XXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXXKXXKXXXKXXXKXXXXXKXXXKXKX 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXX 
XXXXXXXXXXXXXXXXXKXKXXXXXXXKXXKXXKXXXXKXKXXKX 
FIM! 


Existem apenas dois passos para rodar o programa, mas o processo é desajeitado. Deve-se 
digitar a linha (a declaracdo de atribuicdo), e se for digitado RUN ao invés de GOTO, tudo deve 
ser reiniciado. Porém, o programa poderia obter o caractere durante sua execuc¢ao, usando a decla- 


racao INPUT. 


Digite a linha seguinte: 


I200 


Agora liste 0 programa para se certificar que tudo foi digitado corretamente: 


ILIST 
200 
210 
wel) 
230 
2 4Q) 
al) 


Vows “bee 


INPUT C§ 


INPUT C$ 

FOR T = 4 TO 8O0 
PRINT (€¢% 

MEXT I 

PRINT “FIM 

END 


Rode o programa. O cursor desce uma linha. (No Applesoft aparece um ponto de interro- 
gacdo a frente do cursor também.) Digite qualquer caractere unitdrio (e acione RETURN). O 
Caractere entrado 6 mostrado 800 vezes. Rode o programa novamente. Entre um caractere dife- 
rente. O mesmo acontece com o outro caractere. Veja que se for tentado colocar mais de um 
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Caractere por vez no Integer BASIC, o programa para com a mensagem *** STR OVFL ERR. 
Isso 6 porque o C$ nao foi dimensionado. 

Essa € uma melhoria significativa sobre o programa original. Entretanto atrapalha um pouco 
ter o cursor piscando na tela enquanto se espera uma digitacao pelo teclado. Adicione uma linha 
no inicio do programa, pedindo a digitac¢do de um caractere. Digite esta linha: 


JT90 PRINT “ODIGITE UM CARACTERE.” 


Liste o programa e verifique se a linha foi digitada sem erros. 

Agora o programa da instrucdes ao-operador. Rode-o varias vezes para mostrar caracteres 
diferentes e veja como a operacao ficou muito mais facil. 

Existe uma importante alteragdo por fazer. Se for desejado que se repita varias vezes a 
execucdo do programa, use a declaracdo GOTO para voltar ao inicio do programa em vez de fina- 
lizar. Assim nao é mais necessdrio redigitar RUN a cada vez que se deseje nova passagem. Coloque 
a linha abaixo: 


J250 GOTO 190 


Agora ficou ainda mais facil de operar. Entre o RUN e siga as instru¢oes. 

Claramente, deve-se usar agora o CTRL-C para parar o programa. Isso pode ser eliminado 
programando-se uma tecla especial para parar a execucao. Por exemplo, a tecla RETURN poderia 
ser programada para tal fim. Aqui esta como: 


190 PRINT “ENTRE UM CARACTERE” 
LOO INPUT 

200 LF Ce = °* THEN END 

210 FOR I = 1 TO 200 

220 PRINT M$ 

oou NEAT J 

2409 PRINT “FIR” 

230 GOTO 190 


A linha 205 verifica se C$ tem valor nulo. Isso acontecera quando nada for digitado em res- 
posta a4 declaracado INPUT da linha 200, sendo apenas acionada a tecla RETURN. 

Como tarefa final, releia o programa e adicione comentarios. Inclua uma observacao no 
(ndice 800 do FOR-NEXT; pode-se opcionalmente colocar 0 comentario na mesma linha, usando 
os dois pontos para separar as declaracoes: 


210 FOR T=1 TQ BOOSREM 8SO0/40=20 
Informe que uma entrada nula termina o programa: 
20S REM FIM DE PROGRAMA COM ENTRADA HULA 


Finalmente, adicione algumas linhas de comentario no inicio para descrever o programa, e lhe dé 
um nome. O formato final é mastrado na Figura 4.3. 
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10 REM ******* REPETECO ******* 
20 REM MOSTRA CONTINUAMENTE 
30 REM O CARACTERE 

40 REM DIGITADO NO TECLADO 

BO REM #88 RRR ERE EEE E EEE EEK 
190 PRINT “DIGITE UM CARACTERE” 
200 INPUT C$ 


203 REM FIM DE PROGRAMA COM NULO 
205 IF C$ = “ " THEN END 

210 FOR | = 1 TO 800: REM 800/40 = 20 
220 PRINT C$ 

230 NEXT | 

240 PRINT “FIM” 

250 GOTO 190 





FIGURA 4.3. Programa REPETECO. 


Mensagens de Orientacao 


Qualquer programa que requeira dados deve orientar 0 operador fazendo perguntas. Essas per- 
guntas sao geralmente apresentadas numa so linha e pedem respostas simples, como “sim” ou 
‘“‘nao’’. Por exemplo, a seguinte mensagem pode aparecer: 


VAI FAZER ALGUMA ALTERAGAO? 


Um operador deve responder a essa mensagem com a palavra SIM ou com a palavra NAO. 
Em geral, as letras S ou N sao suficientes. Um outro exemplo como este é 0 que da ao operador um 
leque de opcodes. A mensagem: 


QUE ITEM DEVE SER ALTERADO? 


pode permitir que o operador digite o cddigo que identifica a entrada desejada. 

Os programas que controlam este tipo de didlogo devem ser escritos como sub-rotinas inde- 
pendentes que ndo assumem nada, nem dependem de conhecimento do programa que as esta 
chamando. Isso tem trés aplicacGes: 


1. Nao se pode considerar que o local em que a mensagem sera impressa esteja em branco. 
Se ndo estiver, a mensagem sera colocada em cima da anterior. Porém se existirem carac- 
teres ndo cobertos pela mensagem, eles ficardo !4. Isso pode atrapalhar o operador e leva- 
lo a erro. A sub-rotina seguinte limpa o nimero de espacos determinado pelo valor da 
variavel ER: 

32000 REM LIMXMPA ESPACOS 
SOO FoR £ = + TO ERSPRINT “ “NEXT TERETOURN 
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2. Uma sub-rotina deve receber informacdo do programa que a chamou. Por exemplo, se a 
sub-rotina pede ao operador um numero, entdo todo programa que a utilize deve especi- 
ficar os valores maximo e minimo aceitaveis na digitacdo. 


3. A sub-rotina deve devolver a resposta do operador ao programa origem. Pode ser um 
caractere (como S ou N), uma palavra (como SIM ou NAO) ou um nimero. 


A ldgica da sub-rotina ndo consegue deduzir em que parte da tela a mensagem aparecera. O 
mais simples, no caso, é que 0 programa origem posicione o cursor antes de chamar a sub-rotina. 

Veja agora a sub-rotina necessdria para fazer uma pergunta que retorna um S para SIMe um 
N para NAO. Usaremos a declaracdo PRINT para fazer a pergunta, seguida de INPUT para receber 
a resposta de um caractere. Limparemos parte da tela com a sub-rotina acima. Aqui esta o progra- 
ma e as sub-rotinas: 


YOO REM MOVE O CURSOR 

140 VTAR 4 

150 REM CHAMA SUBRGOTING PARA FEDIR RESPOSTA 
160 GOSUB 2OQ20 

170) END 

3000 REM ++ PEGA A RESPOSTA S/N ++ 

sui REM 

2020 CePOS CO EREM GUARDA COLUNA OO CURSOR 
SO30 RePERK C372 2REM GUARDA LINHA DO CURSOR 
2040 REM LIMPA ESPACGS PARA A PERGUNTA 
2OS0 ER S52REM LIMPA 33 ESPACOS 

3060 GOSUB S010 

2070 HTAB C+13REM REPOSICAOQ DO CURSOR 

SO80 PRINT “QUEER FAZER ALGUMA AL TERACAQ” 
SO90 INPUT KR 

S100 TF RE="S" OR R€=°N" THEN RETURN 

S110 REM RESPOSTA IMPROPRITA 

2120 VTA RETEREM REPOSTCTONA CURSOR 

S130 GOTO SQSQ2REM TENTA NOVAMENTE 

3000 REM ++ LIMPA ESPACOS +4 

SOTO FOR T=7 TO EREPRINT “~ “SWNEXT TERETURN 


Veja agora o didlogo que permite ao operador a entrada de um numero. Vamos criar uma 
sub-rotina que aceita resposta ndo menor que o valor da variavel MI e nado maior que a variavel MA. 
Aqui esta o programa necessdrio: 


100 REM DA LIMITES & POSTICAG DO CURSOR 
140 MI=TiMA=10 

150 VTAB 4 

140 REM CHAMA SUBROTINA PARA RESPOSTA 
170 GOSUB 3200 

F8O ENE 

2JU0 REM ++ FPEGA RESPOSTA NUMERICA +4 
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3510 REM +4 MICRESPOSTACMA +4 

2520 REM ++ NM E A RESPOSTA +4 

3530 GOSUB S11O2REM ONDE ESTA O CURSOR 
2940 REM LIMPA ESPACO PARA PERGUNTA 

S950 ERSS52REM LIMPA 35 ESPACOS 

3540 GOSUR SO-+40 

3470 HTAB C+12REM REPOSICIONA CURSOR 

3580 PRINT “QUE CAMPO DEVE SER MUDADO ?”: 
2590 INPUT NM 

3600 IF NM>MI AND NM¢MAa THEN RETURN 

2610 REM RESPOSTA IMPROPRIA 

2620 VTAB L41EREM REPOSICIONA CURSOR 

2630 GOTO 3550: REM TENTA DE NOVO 

SOQ00 REM ++ LIMPA ESPACOS +4 

SO10 FOR T=4 TO ERSIPRINT “ “fNEXT TIRETURN 
S100 REM ++5UARDA POS.ATUAL DO CURSOR +4 
S110 C7 PEEK(36)2REM COLUNA 

S420 Le PEEK (S7)2REM LINHA 

“130 RETURN 


a4 Rts 3 


— 


Pode-se modificar a sub-rotina de forma que ela aceite entradas de dois caracteres? Tente 
modificar 0 programa por sua conta para fazer isso, entao espere irmos um pouco mais adiante 
neste capitulo, onde se encontra a sub-rotina necessdria no programa que controla entrada de 
dados. 

Existe outra modificacao simples em ambos os didlogos que mostramos. As mensagens de 
orientacdo podem ser fornecidas pelo programa que chamou a sub-rotina. Isso a torna de aplica¢ao 
muito mais genérica. Tente fazer essas alterac¢des no programa. 


Deteccao de Erros e Controle 


Se for desejado fazer um programa de boa qualidade deve-se realizar um grande esforco para prever 
a possibilidade de ocorréncia de erros que o usuario do programa possa fazer. O programa deve 
achar erros e forcar o operador a redigitar os valores que fariam o computador operar de forma 
anormal (estourar, na linguagem ‘‘computés’’). 

E verdade que o Apple I! acha alguns tipos de erros para nds. Ele nao aceita entrada alfabeé- 
tica quando espera dados numéricos numa declaracdo do tipo INPUT A. Se for tentado colocar 
letras neste caso, 6 dada uma mensagem de erro e se pede para redigitar o valor. 

A capacidade de deteccdo de erros embutida no sistema é limitada. E bem possivel digitar 
um tipo de dado correto (ou seja, cordéo ou numérico) com um valor inaceitavel. Isto é, o valor 
pode causar um erro no programa num ponto posterior. Aqui esta um pequeno programa que 
demonstra o problema: 


1O0 TNPUT x 
200 PRINT 1o00/x 
200 END 
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Se for digitado 0 em resposta 4 declaracao INPUT, o programa estoura quando tentar dividir 
por O na declaracdo PRINT. E bastante facil evitar isso. As linhas seguintes testam a entrada para 
ter ciéncia que o valor nao é 0, e pedirdo outro numero se for. 


4490 TF AS?0D THEN 200 
120 PRINT “NAO PERMITIDO;DIGITE DE NOVO” 
130 GOTO 100 


Estendendo os principios mostrados neste exemplo, pode-se ver o quanto facil é testar um 
valor entrado para manter os limites possiveis. Dependendo das circunstancias, pode ser melhor 
testar os limites com o ON-GOTO do Applesoft ou o ON-GOSUB (GOTO e GOSUB calculados do 
Integer BASIC), ao invés da série de declaracdes IF-THEN. Existe um exemplo de deteccdo de 
erros mais elaborado na proxima secao. 


O ONERR GOTO e a Declaracaéo RESUME 


O Applesoft tem uma declaracdo especial que permite contornar erros quando os encontra — antes 
que seja colocada uma mensagem ou pare a execucdo do programa. Aqui esta um exemplo: 


§Q ONNER Goro Bann 


Uma vez dada esta declaracdo, quando o Applesoft encontrar um erro, pulara para o ende- 
reco 8000. Também sera mostrado um cddigo numérico descrevendo o erro na posicao de memoria 
222, que podera ser consultada através de uma declaracdo PEEK. A Tabela C.1 no Apéndice C 
tem a relacao de condicGes de erros detectaveis pelo ONNER GOTO. 

A forma usual de tratar os erros com o ONNER GOTO 6 escrever uma rotina para onde o 
programa va quando ocorra um erro. No final dessa rotina, a declaracdo RESUME causa o retorno 
para o inicio da declaracdo onde ocorreu o erro. Alternativamente, uma declaracdo GOTO man- 
dara o programa para qualquer endereco. Escreva a rotina de erro de forma que ela tome atitudes 
diferentes dependendo da natureza do erro e do estado presente do programa, o que pode even- 
tualmente ser verificado pela andlise dos valores das variaveis-chave. 

Para cancelar o ONNER GOTO e fazer o Apple II voltar 4 sua forma normal de tratamento 
de erro, use a declaracdo POKE 216,0. 

O programa seguinte demonstra o uso do ONNER GOTO. Neste programa, quaisquer erros 
que nao possam ocorrer como resultado de operacao de entrada via teclado sdo tratados como 
fatais, com o aparecimento de uma mensagem de adverténcia. A entrada é desconsiderada e é 
requisitada nova digitacao. 


SO ONNER GOTO Sono 

200 PRINT “ENTRE UM VALOR ALP ANUMER TOO” 
210 INPUT x4 

220 PRINT “ENTRE UM VALOR NUMER ICO” 

230 INFUT x 

2460 PRINT “ENTRE UM YALOR INTETRO” 

250 INPUT x% 

260 GOTO 200 

SOO REM FIM DO PROGRAMA 
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S10 PRINT “ULTIMA ENTRADA FOL “3X#,", “EX9" EB v3xy 

S18 POKE 244,/0:2REM DESLIGUE POR ERRO 

S20 END 

2000 REM ++ ROTINA DE ERRO +4 

8010 E = PEEK (222):REM PEGA NUMERO DO ERRO 

S020 .F E = 259 THEN GOTO SOOQ:REM FIM CE PROGRAMA 
COM OTRL-C 

S020 IF Eo = $8 OR E = 474 OR E = 254 THEN S400 

8038 TNVERSE 

RO40 REM DETECTADO ERRO DE PROGRAMACAG 

S080 PRINT “ARRGH! DETECTADO ERRO NUMERO “TE 

ROSS PRINT “DEIXE © NUMERO N@ TELA” 

S040 PRINT “E @ DESCRICAO DO OCORRIDG.” 

S070 PRINT “CHAME UM PROGRAMADOR PARA AUXILIA-LO.” 

2080 PRINT “DELXE © COMPUTADOR LIGADO.” 

S090 NORMAL = STOP 

RANG REM DETECTADO ERRO DE ENTRADA DE DADO 

S440 PRINT ““oSREM CARFACTERE CTRL-G ENTRE ASPAS 

S120 PRINT “ERRO, TENTE NOVAMENTE” 

8490 RESUME 


Entrando uma Data Véalida 


Nesta parte descreveremos um programa que usa varias técnicas apresentadas neste capitulo. Sao 
usadas algumas funcdes do BASIC e declaracdes disponiveis apenas no Applesoft. O programa 
pode ser escrito em Integer BASIC; pode-se fazer a conversao. 

Muitos programas, em algum ponto de sua execucdo precisam de entrada de dados nao tao 
simples quanto um sim ou nao, porém nao tao complexas quanto uma tela inteira. Considere uma 
data. 

Deve-se ter mais cuidado com essa entrada de dados simples do que a primeira vista parece 
necessaério. E muito provavel que a data seja apenas um item dentro de uma seqUéncia. Tomando o 
devido cuidado com cada um dos itens numa digitacdo, pode-se evitar a digitacao de muitos itens 
sempre que o Operador se esqueca de um dado. 

Assume-se que a data seja colocada na seguinte forma: 

MM — DD — AA 
=~ 


—_—— —m— 


= 


Ano 
|__________ Senarador 
Dia do més 


Separador 
Més 


| 


O més, dia do més e ano sdo, cada um, entrados como sendo dois digitos numéricos, colo- 
cados sem a terminacaéo RETURN. 
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O programa fornece os tracos de separacdo entre os elementos. Dependendo de sua prefe- 
réncia, pode ser uma barra ou outro caractere desejado. Em muitas partes do mundo o dia prece- 
de o més. 

Programe a entrada de dados de forma que fique agradavel ao operador. Ele deve reconhecer 
facilmente onde o dado deve ser colocado, que tipo de dado é e o que vem depois. Uma forma 
interessante de mostrar onde o dado deve ser colocado é mostrar 0 nome do campo em video 
reverso. Por exemplo, o programa que pede a data pode ser criado da seguinte forma com video 


reverso: 
r piscando na posicao do dado a ser entrado 


LO-LO-EE) 


——_ ir —— 
Os dados devem ser entrados nessas posicdes 


Pode-se criar o visual deste programa como segue: 


10 HOME: VTAB 3: HTAB 20: REM POSICAG PARA ENTRADA 

20 IW = 2: GOSUB 1100: REM CAMPO DE ENTRADA DE @ DIGITOS 

30 PRINT “-"3 

40 GOSUB 1100! REM CAMPO DE ENTRADA DE 2 CARACTERES 

SO PRINT “~“3 

60 GOSUB 1100: REM CAMPO DE ENTRADA DE 2 CARACTERES 

70 VTAR 32 HTAB 20! REM REPOSICAO PARA INICIO Do 
CAMPO DE ENTRADA 

80 END 

1090 REM ++ MOSTRA “TW ESPACOS EM BRANCO +4 

1100 INVERSE 

1440 FOR T= 4 TO IW PRINT “ “fa NEXT I 

1420 NORMAL. 

1130 RETURN 


O programa acima inclui declaracdes que posicionam a digitacdo da data na coluna 21 e linha 
3. Também é limpa a tela de forma que qualquer bobagem anterior nao atrapalhe a introducado 
do dado. Apés a apresentacado do dado entrado, o cursor se move de volta para a posicdo do pri- 
meiro campo de entrada, embora isso nao possa ser apreciado devido a declaracado END. 

Tente usar a declaracdo INPUT na linha 80 para receber o primeiro item da data: o més. Isso 
pode ser feito como segue: 


BO INPUT M¢ 
PQ END 


Digite as declaracdes nas linhas 80 e 90 como acima e execute o programa. Como se vé, a 
declaracao INPUT nao opera. Fora o fato do ponto de interrogacao deslocar o primeiro caractere 
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do campo de digitacdo, o acionamento do RETURN faz limpar todo o resto da linha de digitacao. 
Esta é a ocasido de usar a declaracdo GET. Coloque as seguintes linhas adicionais de programa: 


6 GOSUB T2002 MME = Sl REM PEGA PRIMETIRO DIGITO 


of) GOSUB T2005 MM = MM& + Ces REM PEGA SEGUNDO 
BIGITO O90 MES 

190 REM ++ ACEITA UM CARACTERE DIGITADO 

4200 GET C$ 

1210 PRINT (G3: REM APRESENTA A DIGITACAO NO VIDEO 

T2ekO RETURN 


Essas declaracGes aceitam a digitacdo de dois caracteres. A entrada é mostrada no primeiro 
campo reverso da data. A entrada dos dois digitos ndo pede RETURN ou outro terminador qual- 
quer. O programa para se pedir dados apds a entrada do segundo caractere. 

Sado necessdrias trés entradas de dois caracteres cada: para o més, dia e ano. Ao invés de 
repetir as declaracdes das linhas 80 e 90, colocaremos estas declaracdes numa sub-rotina e iremos a 
ela trés vezes, como segue: 

PO GOSUE T1300: MMS = CCS: REM PEGA MES 

ST) PRENT “+39 REM ESPACG PARA GO PROXTMO CAMPO 

180 $OSUB 1300: DOS = CCH: REM PEGA DIA 

{90 PRINT “+t: REM ESPACO PARKA O FROXIMO CAMPO 

220 GOSUR T2008 AA = MNEs REM PEGA ANG 

2PQ END 

1290 REM ++ PEGA ENTRADA DE 2 CARACTERES ++ 

{300 GO@SUR Taos CO = Oe + TEs REM PEGA SEGUNDO 
CAR AC PERE 

{220 RETURN 


As variaveis MM$, DD$ e AA$ tém o més, dia e ano, respectivamente. Cada entrada tem dois 


caracteres. 
Existem duas formas pelas quais se pode ajudar o operador a se recuperar de erros durante a 


digitacao. 
1. O programa pode testar automaticamente a validade do més, dia e ano. 


2. Pode ser dada ao operador a chance de redigitar estes itens. 


O programa pode testar o més entre 1 e 12. Os anos bissextos nao precisam ser considerados, 
porém pode-se testar a existéncia de um dia num dado més. Qualquer ano entre 00 e 99 sera per- 
mitido. Qualquer digitacdo invalida fara o programa requisitar todos os itens novamente. 

Se o operador acionar a tecla RETURN, toda a seqUéncia reinicia. Nossa versdo final do 
programa de entrada de dados ficara assim: 


132 


10 
1% 
17 
18 
19 
20 
30 


é {} 


&S 


80 
8-1 
$0 


100 
110 


120 
125 
130 
133 
140) 
420 
140 
4169 
170 
ay 
180 


4°O 
200 
L&F 
2/70 


ar | 
a f31) 
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HOME = VTAB 3: HTAB 20 © REM POSTCIONA PARA DIGITACAO 
RCS = CHRS (€13)2 REM PERMITE REINICIO DE DIGITACAO 
REM 

REM MOSTRA 3 CAMPOS DE 2 CARACTERES CADA 

REM 

TW = 2: GOSUB 71100 

roin. o=*" 

GOSUB 1100 

PRinugG C=" 

GOSUB 1700 

PRINT “"3: REM CTRL-G = BELL 


REM 
REM PEGA ENTRADA DE 3 CAMPOS 
REM 


VTAB 3: HTAB 3: REM POSICIONA NA INICTO DOS CAMPOS 
DE ENTRADA 
REM 
KEM PEGA MES 
FEEL 
GOSUB 1300: IF C$ = RC THEN GOTO 10: REM TESTE PARA 
REINICIO DE ENTRADA 
MM = VYAL CCCS)5 REM MES EM NUMERTICO 
IF MM ¢ 1 OR MM > 12 THEN 10: REM TESTE DE MES 
TNEXISTENTE 
DYE = CCHs PRINT “-*Fs REM AYVANCA PARA PROXIMO CAMPO 
REM VE O MATOR NUMERO DE DIAS DESTE MES 
DM = ST! REM ASSUME 27 DIAS 
REM A MENOS DE FEVERETRO 
IF MM = 2 THEN DM = 29 
REM OU ABRIL, JUNHO, SETEMBRO OU NOVEMBRO 
TF MM = 4 OU MM = 6&6 OR MM = 9 OR MM = 11 THEN DM = 30 
REM 
REM PEGA DIA 
REM 
GOSUB 1300: IF C# = RCS THEN GOTO 10 © REM TESTE PARA 
REITNICTO DE DIGITACAO 
GO = VAL CCC$)s TF OD 4 1 OR DD > DM THEN 10° REM 
REINTICIO SE ENTRADA FOI INVALIDA 
DT = OTS + “-" + CCS PRINT “-"2 REM AVANCA PARA 0 
PROXIMO CAMPO 


REM 
REM PEGA ANO 
REM 


GOSUB T3002 IF C#% = RCS THEN GOTO 10:5 REM TESTE PARA 
REINICTO DA DIGITACAS 
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270 YY¥ = VAL. ClCOSI: IF Y¥ < O GR YY + 99 THEN 105 REM 
RETNICTO PARA ENTRADA INVALIDA 

400 OTF = OT4 + *=" # CCS 

2a7 REM 

370 REM MOSTRA A ENTRADA 

a7. 06ORES 

400 VTAB ¢10): HTAB ¢€1835 PRINT “DATA DIGITADAS” 

410 VTAB C1133 HTAB C18) PRINT DT$ 

420 END 

1069 KEM 

TO?9O REM ++ MOSTRA “TW” CARACTERES EM BRANCO REVERSO +4 

suU71 REP 

V1N0O INVERSE 

4110 FOR I = 4 TO IWt PRINT “ “35 NEXT I 

1120 NORMAL. 

4130 RETURN 

1489 REM 

4190 REM ++ ACETTA ENTRADA DE 1 CARACTERE +4 

1491 REM 

4200 GET Ce: ITF CH = °* THEN 7200 

1210 IF ©$ = ROS THEN RETURN? REM TESTE PARA RETNICTIO 

1220 TF cs < “0" OR C# > “9” THEN 1200 

1230 PRINT C#s: REM SAI CARACTERE 

7240 RETURN 

Teo? KER 

1290 REM ++ PEGA ENTRADA DE 2 CARACTERES ++ 

{291 REM 

4300 REM PEGA PRIMEIRO CARACTERE? TESTA RETNICTO 

1310 GOSUB 1200: IF C# = RC THEN RETURN 

1315 CCS =C$% 

1320 REM PEGA SEGUNDO CARACTERE?: TESTA REINICIO 

1330 GOSUB 1200: IF C# = RCd THEN RETURN 

1340 RETURN 


Note que a data ficou presente num campo cordao de 8 caracteres, o DT$, apds a digitacdo 
do més, dia e ano. 


Sado feitas trés verificagdes nos dados no momento da digita¢ao: 
1. O caractere 6 carriage return? 
2. Se nao, é um caractere valido? 


3. A combinacao de 2 caracteres 6 um més valido para a primeira digitac¢ao, um dia valido 
para a segunda e um ano valido para a terceira? 


Selecionamos o carriage return para caractere de reinicio. Trocando o CHR$(13) na linha 15, 
pode-se selecionar qualquer outro caractere que se queira. Quando o operador aciona‘a tecla esco- 
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lhida, toda a sequéncia de entrada é reiniciada. Deve-se perguntar pelo caractere de reinicio a cada 
um digitado, na rotina apropriada (na linha 1200) e depois na sub-rotina de digitacdo de dois 
caracteres (na linha 1300) desde que desejamos estar aptos a voltar ao inicio da digitacdo do 
primeiro ou segundo caractere. O programa principal também verifica se o caractere de reinicio foi 
digitado para voltar para a linha 10 e reiniciar toda a entrada de dados. Poderfamos também pular 
diretamente da rotina de entrada de um caractere para a linha 10, eliminando assim outros testes. 
Porém nado é uma boa pratica sair de uma sub-rotina com um GOTO ao invés de um RETURN. 
Toda a sub-rotina deve ser tratada como um modulo ldégico, com parametros especificos de entrada 
e retornos padronizados. Sair de uma sub-rotina de qualquer outra forma conduz facilmente a 
programas dificeis de entender e a erros de programacdo. (Lembre-se que antes de se sair de uma 
sub-rotina sem o RETURN, deve-se dar um POP para limpar o endereco de retorno que ficou guar- 
dado.) 

A légica do programa que testa os caracteres nado numéricos ficou inteiramente localizada 
dentro da digitag¢do de um caractere. Ignoramos digitos ndo numéricos. A declaracdo que faz isso 
esta na linha 1220. 

A légica para teste de més, dia e ano validos deve estar contida dentro do programa principal 
(fora da sub-rotina) desde que cada uma dessas entradas tem um limite permitido diferente. 

A declaracao da linha 110 testa o més valido. 

As declaragdes das linhas 130, 140 e 160 verificam o maximo dia permitido para o més 
entrado. A declaracao da linha 190 testa um dia valido. 

O teste de validade do ano é bem simples, e esta na linha 290. 

Leva-se mais tempo para escrever um programa com entrada de dados que mostrem infor- 
macoes de forma mais concisa e testa-se a validade dos parametros, permitindo ao operador a redi- 
gitac¢ao a qualquer momento. Sera que esse tempo é bem gasto? Muito bem gasto. O programa 
sera escrito uma sO vez; j4 0 operador processara a rotina centenas ou milhares de vezes. Dessa 
forma sera gasto um tempo extra por uma vez, para que o operador nao tenha centenas ou milha- 
res de atrasos. 


FORMAS DE ENTRADA DE DADOS 


A se¢do seguinte descreve algumas técnicas de programa¢do que sao melhor implementadas no 
Applesoft. Muitos dos efeitos especiais usados neste exemplo de programa sao dificeis, ou mesmo 
impossiveis, de se obter com o Integer BASIC. Se nao houver outra alternativa além dele, ainda 
podera ser interessante a leitura desta secdo para o aproveitamento eventual de algumas técnicas 
com o Integer BASIC. 

A melhor forma de se entrar muitos itens num programa é apresentar um formuldrio na tela, 
e preenché-lo com os dados entrados. Considere um nome e endereco. Primeiro apresente um 
formuldrio como abaixo: 


ENTRE NOME E ENDERECO ABAIXO 
if NOME: 
#1] ENDERECO: 
€} CIDADE: 
5! ESTADO: =) CEP: 
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Veja que a cada item estd associado um numero. O ntimero do campo aparece em video 
reverso neste formuldrio. 

O operador entra os dados seqiiencialmente, comecando com o item 1 e terminando com o 
5. O operador pode entao alterar qualquer campo. 

O programa seguinte limpa a tela e mostra o formuldrio inicial: 


109° REM 

110 REM MOSTRA O FORMULARTO DE ENTRADA DE DADOS 

174 REM 

120 CALL -996! UTAB 2: REM LIMPA A TELA & 
POSTCIONA O CURSOR 

125 PRINT “ENTRE O NOME E ©O ENDERECO ABATXO"” 

130 REM PRIMEIRO MOSTRA OS NUMEROS DOS CAMPOS” 

140 INVERSE 

190 FOR IT = 4 T0 45 HTAB 2: PRINT Ti NEXT I 

160 VTAB 6: HTAB 29: PRINT & 

170 NORMAL 

180 REM MOSTRA OS NOMES DOS CAMPOS 

190 VTAB 3: HTAB 46° PRINT “NOME: ” 

200 YVTABb 42 PRINT “ENDERECO:” 

210 HTAB 6! PRINT “CIDADE: ” 

eeQ HTAB St PRINT “ESTADO: 

230 HARB STS PRINT “CEP:” 


Serdo criados campos de video reverso para informar onde os dados entrados devem ser 
colocados 4 medida que vao sendo digitados. O CTRL-X é usado para reiniciar a entrada de dados 
no campo corrente. A tecla RETURN termina a digitacao do campo. A seqUéncia de instru¢des 
seguinte fornece a ldgica de programa necessaria: 


100 RC& = CHR (24): REM CTRL-X COMO CARACTERE DE REINICIO 
200 REM 

200 REM ENTRA TODOS OS 5 CAMPOS 

204 REM 

340 FOR IT = 4 TO St GOSUB 1900: NEXT F 

320 END 

990 REM +4++4+444+4 SUBROTINA 1000 444444444444 

991 REM ENTRA CORDAO DE DADOS NO CAMPO COM LN CARACTERES 
992 REM O CURSOR DEVE ESTAR NA PRIMEIRA POSICAO DO CAMPO 
993 REM A TECLA RETURN TERMINA © CAMPO 

994 REM A TECLA “FLEXA A ESQUERDA” REINICIA A ENTRADA 

995 REM NAO TESTA A VALIDADE DO DADO ENTRADO 

996 REM 0 CORDAO ENTRADO VOLTA EM CCS 

O97 REM 

1000 HT = POS (0) + 42 REM LEMBRA POSICAO DO INICIO DO CAMPO 
1040 REM MARCARA COM VIDEO REVERSO 

1020 INVERSE 

1030 FOR T = 4 TO Nt PRINT “ “$2 NEXT I 

1040 NORMAL? HTAB CHT): REM REFOSICIONA NO INICIO DO CAMPO 
1050 REM ENTRA DADO 
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1060 
1070 
1080 
1090 
1100 
1110 
1120 
1120 
1140 
1150 
1140 
1170 
1889 
1890 
1994 
1900 
1989 
1990 
1994 
2000 
2010 
2089 
2090 
2094 
2100 
2110 
2189 

2190 

2194 

2200 
2240 
2289 
2290 
2294 

2300 
2340 
2389 
2390 


aa? 
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COS = ““: REM INICTA ENTRADA COM NULO 

GET C$ 

TF C$ = RC# THEN HTAB CHT): GOTO 1020: REM REINICIA ENTRADA? 
IF C$ = CHRS €13) THEN GOTO 1140: REM FIM DE ENTRADA? 

REM QUANDO ENTRADA TERMINA, ESPERA POR RETURN OU REINICIO 
TF LEN (CC) = LN THEN GOTO 1070 

PRINT Cs: REM SAI CARACTERE TECLABO 

COS = CCH + CH: GOTO 1070 

Jo= LEN (CC) 

FOR IT = J TO LN: CCS = COS + ” “8 NEXT I 

REM RECOLOCA A ENTRADA 

HTAB CHT): PRINT CCGs: RETURN 

REM +4++4+4++4++44+4 SUBROTINGA 1900 4+44444444444444 

REM PULA PARA ROTINA DE ENTRADA PARA CAMPO NUMERO F 


REM 

ON F GOTO 2000,2100,2200,-2300, 2400: RETURN 
REM 

REM ENTRAM 20 CARACTERES ~-NOME- 

REM 


VTAB 3: HTAB 14 

LN = 20: GOSUB 1000: NAS = CCS: RETURN 
REM 

REM ENTRAM 20 CARACTERES - ENDERECO - 
REM 

YTAB 4:2 HTAB 41 

LN = 202 GOSUB 1000:CI¢= CC$: RETURN 
REM 

REM ENTRAM 20 CARACTERES - CIDADE - 
REM 

VTAB St HTAB 11 

LN = 20: GOSUB 1000: RETURN 


REM 
REM ENTRAM 18 CARACTERES - ESTADO - 
REM 

VTAB & } HTAB 44 

LN = 18: GOSUB 1000: ST$ = CC: RETURN 
REM 

REM ENTRAM % CARACTERES ~ CEP - 

REM 


Digite 0 programa inteiro da declaracdo 100 até 2410 e execute. Lembre-se de que ainda 


existem as declaracoes de 109 a 230 digitadas do exemplo anterior, de forma que nao é necessario 
recolocar. 


Se o programa nao rodar direito, confira a listagem com cuidado. Em particular as declara- 


coes PRINT. 


Na execucdo do programa, cada um dos cinco campos vai ficar destacado por sua vez. Assim 


que os caracteres forem digitados eles serao transferidos para o video. Ao se acionar o RETURN, 
todo o campo sera substitufdo pelo contetdo final teclado. Tente o uso de CTRL-X para reiniciar 
a entrada de dados. 


Analise com cuidado a légica da sub-rotina de entrada de cordao, iniciando na linha 1000 e 


indo até a 1170. Antes de seguir adiante sugere-se que se entenda perfeitamente a lOgica embutida 
nesta parte. 
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Veja como é facil entender o que se esta digitando, e como é facil reiniciar a digitacado para 
corrigir erros. 

Depois da digitagdo completa de nome e endereco, o programa deveria perguntar ao opera- 
dor se algum campo deve ser alterado; depois deveria pedir qual o campo. Uma rotina de pergunta 
SIM-NAO ja foi vista antes neste capitulo. Usaremos uma versdo modificada dela, onde o programa 
que chama fornece a pergunta a ser feita ao operador. Aqui esta a listagem completa do programa 
adicionando os comentarios necessarios. 


DP REM MEXR KKK RRM HK MMM HM HK KM MK KK KEK KK KER KM MK KK KEK 
JO REM ESTE PROGRAMA MOSTRA UM FORMULARTO PARA ENTRAR NOME E ENDERECO 
i1 REM E PEDE EM SEGUIDA A ENTRADA DESSES DADOS 

42 POEM HE 3G 9G 35 SE 36 FE 9G 9E HG HE HE FE IE HE FE HE HE HE 2G BE HG SE HE HEE HEHEHE BEG EE HE HE EH HK HEH HH MH HH HEM HK 
13 REM 

100 RC& = CHRS (24) |: REM CTRL-X = CARACTERE DE REINICIO 

109 REM 

110 REM MOSTRA O FORMULARIO BE ENTRADA DE DADOS 

4111 REM 

120 CALL -9346: VTAB 2: REM LIMPA A TELA E POSICIONA O CURSOR 

{25 PRINT “ENTRE © NOME E 0 ENDERECO ABAIXO” 

130 REM PRIMEIRO MOSTRA OS NUMEROS DOS CAMPOS” 

140 INVERSE 

450 FOR I = 4 TO 42 HTAB 2: PRINT It NEXT I 

140 YTAB 6: HTAB 29: PRINT 5 

170 NORMAL 

180 REM MOSTRA OS NOMES DOS CAMPOS 

190 VTAB 3: HTAB 4: PRINT “NOME:” 

200 VTAB 4: PRINT “ENDERECO:” 

210 HTAB 6: PRINT “CIDADE:” 

220 HTAB St PRINT “ESTADO:” 

230 HTAB 31:5 PRINT “CEP:” 


299 REM 

300 REM ENTRA TODOS OS S&S CAMPOS 

301 REM 

S10 FOR IT = 1 TO St GOSUB 1900: NEXT F 
320 END 


990 REM +4+4+44444+ SUBROTINA 1000 +4+44+4+4+4+4+44+4+ 

991 REM ENTRA CORDAO DE DADOS NO CAMPO COM LN CARACTERES 

992 REM O CURSOR DEVE ESTAR NA PRIMEIRA POSICAO DO CAMPO 

993 REM A TECLA RETURN TERMINA © CAMPO 

994 REM A TECLA “FLEXA A ESQUERDA” REINICIA A ENTRADA 

995 REM NAO TESTA A&A VALIDADE DO DADO ENTRADO 

99& REM 9 CORDAO ENTRADO YOLTA EM CCS 

777 REM 

1OOO0 HT = POS (0) + 12 REM LEMBRA POSICAO DO INICIO DO CAMPO 
1O10 REM MARCARA COM VIDEO REVERSO 

1020 INVERSE 

1030 FOR I = 41 TOLNS PRINT ”~ “35 NEXT I 

1040 NORMAL: HTAB CHT)! REM REPOSICIONA NO INICIO DO CAMPO 
1050 REM ENTRA DADO 

1060 CCH = “": REM INICIA ENTRADA COM NULO 

1070 GET C$ 

1080 IF C# = RC¢ THEN HTAB CHT): GOTO 1020: REM REINICIA ENTRADA? 
1090 IF C& = CHR (123) THEN GOTO 11405 REM FIM DE ENTRADA? 
1100 REM QUANDO ENTRADA TERMINA, ESPERA POR RETURN OW REINICIO 
1410 IF LEN (CC) = LN THEN GOTO 1070 


4120 
14130 
1140 
1450 
1160 
4470 
1189 
4190 
4194 
1200 
4210 
{22 
{230 
1289 
1290 
129 
1300 
1310 
4320 
4330 
4340 
1389 
4390 
1391 
4392 
14393 
1400 
1410 
1420 
1425 
1430 
1440 
4450 
1889 
1890 
1894 
1900 
1989 
1990 
1994 
2000 
2010 
2089 
2090 
2094 
2100 
2110 
2189 
2190 
2191 
2200 
2210 
2289 
2290 
2291 
2300 
2310 
2389 
2o90 
2391 
2400 
2410 
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PRINT C#32 REM SAI CARACTERE TECLADO 

CC# = CCS + C$s GOTO 1070 

Jj = LEN <CCs) 

ror i = J TO LN? COS = Les + * “s NEXT I 

REM RECOLOCA A ENTRADA 

HYTAB CHT): PRINT CO#s: RETURN 

REM tettettttees SUBROTINA 1200 t4+ttttttttatats 
REM LIMPA A LINHA ONDE ESTA O CURSOR 

REM 

HTAB = 12 REM COMECA NO INICIO DA LINHA 

FOR I = 4 TO 392 PRINT * “3: NEXT f 

HTAB Ti REM DEIXA CURSOR NO INICIO DA LINHA 
RETURN 

REM ++4++4++44+44 SUBROTINA 1300 +44+4+4444444444444 
REM FAZ UMA PERGUNTA (QU) E RETORNA RESPOSTA S OU N EM YN$ 
REM 

BOSUB 1200: REM LIMPA TODA A LINHA 

PRINT QU: REM MOSTRA A PERGUNTA 

GET YN&: IF YN€< O”°N” AND YN & >°Y” THEN GOTO 1320 
PRINT YN€5= REM MOSTRA RESPOSTA : 

RETURN 

REM t+++4++4+4+4+44 SUBROTINA 1400 4444444444444 4+444 
REM PEDE ENTRADA NUMERICA (PERGUNTA QU) 

REM RESPOSTA VEM EM NM 

REM NM DEVE SER <=HI E >=LO 

REM 

GOSUB T2005 REM LIMPA LINHA DE ENTRADA 

PRINT QUGF: REM MOSTRA PERGUNTA 

GET C#s NM = VAL (C$) 

REM YE SE ESTA DENTRO DA FAIXA 

IF NM < LO OR NM > HI THEN GOTO 1420 

PRINT C35 REM SAI RESPOSTA 

RE TURN 

REM +4+4444+4+4444 SUBROTINA 1900 +44444444444444 
REM PULA PARA ROTINA DE ENTRADA FARA CAMPO NUMERO F 
REM 

ON F GOTO 2000,2100,2200,2300,24002RETURN 

REM 

REM ENTRAM 20 CARACTERES ~-NOME- 

REM 

VTAB 3: HTAB 11 

LN = 20: GOSUB 1000: NAS = CC: RETURN 

REM 

REM ENTRAM 20 CARACTERES ~- ENDERECO - 

REM 

VTAB 4:5 HTAB 14 

LN = 202 GOSUB 1000:CI¢= CC$: RETURN 

REM 

REM ENTRAM 20 CARACTERES -—- CIDADE - 

REM 

YVTAB Ss HTAB 11 

LN = 20: GOSUB 1000: RETURN 

REM 

REM ENTRAM 18 CARACTERES - ESTADO - 

REM 

VTAB 4: HTAB 11 

LN = 78:5 GOSUB 1000: ST¢ = CCE: RETURN 

REM 

REM ENTRAM 3 CARACTERES ~ CEP = 

REM 

YUTAB 4: HTAB 35 

LN = S: GOSUB 1000: ZP = CCH: RETURN 
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Estude o programa acima cuidadosamente e entenda a forma como foi feito e as observacdes 
inseridas. Sao elas: 


Ts 


Numerar cada campo e justapor uma mascara de video reverso no momento apropriado, 
isso deixa saliente o campo a ser digitado e o espaco disponivel. 


. Quando o operador entra com o numero do campo para ser modificado, a mascara tam- 


bém informa rapidamente se foi dado o numero de campo correto. 


. O operador nao precisa preencher todos os caracteres de cada campo; ao acionar a tecla 


RETURN, o resto do campo é preenchido com espacos. 


. A qualquer momento pode-se reiniciar a digitacdo com a tecla CTRL-X. 


5. Quando sao feitas perguntas, apenas sdo aceitas respostas com significado, tipo S ou N 


para “sim” ou “‘ndo’’ ou um numero entre 1 e 5 para especificar um campo. Nao é bom 
permitir-se a entrada de respostas sem significado. Por exemplo, aceitar a resposta S para 
“sim‘’ e qualquer outra tecla para ‘’ndo’”’ poderia, por acidente, provocar a safda do pro- 
grama de forma desastrosa. O contrario, aceitar N para ‘‘nado”’ e qualquer tecla para “’sim”’ 
poderia muitas vezes obrigar o operador a redigitar dados desnecessariamente, apenas por 
ter acionado uma tecla errada. 


Abaixo vao outros aperfeicoamentos que nao foram colocados, mas poderiam sé-lo: 


1 


Testar o codigo de CEP para nao haver entrada nula (existem codigos similares em muitos 
paises para permitir entrada alfabética). 


. Os programadores mais cautelosos ainda fazem a pergunta VOCE TEM CERTEZA? 


Quando o operador responde NAO 4a pergunta QUER FAZER ALGUMA MODIFICA- 
CAO? Isso dé ao operador uma segunda chance de redigitar os dados no caso de ter digi- 
tado uma tecla errada. 


. Uma tecla que aborte a entrada atual de dado e devolva o valor anterior. Por exemplo, 


se O Operador alterou o campo errado, 0 programa do exemplo faz com que ele seja forca- 
do a redigitar 0 campo inteiro. Ele poderia facilmente reconhecer uma tecla que elimine 
a entrada e devolva o contetido anterior. 


. Permitir 0 acionamento da tecla < como retorno de espaco. Cada vez que a tecla < for 


acionada, o cursor volta um espaco e o Ultimo caractere entrado é substituido pela mas- 
cara em video reverso na tela e por um caractere em branco na rotina de saida de CCS. 
Claro, nado pode haver o retorno de espaco no primeiro caractere de esquerda do campo. 


Tente modificar o programa exemplo para implementar as melhorias acima. 


FORMATACAO DE SAIDA 


Quando se liga o Apple II, automaticamente a safda é a tela. Existem declaracoes que permitem 
mandar dados para outros dispositivos tal como impressora e outros que aceitem dados de saida. 

Existem algumas diferencas na programacao de saida pela tela em comparacao com impres- 
sora. Por exemplo, a impressora pode ser mais larga que a tela, de forma que uma linha de safda 
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caiba dentro de uma linha da impressora e pule para a linha de baixo na tela. Por outro lado, o 
HTAB e o VTAB (TAB no Integer BASIC) podem ser usados para mover o cursor pela tela, porém 
nado podem ser usados para mover o cursor pelo espaco de uma folha de papel. 

Existem também muitas similaridades nas técnicas de programacdo usadas para criar safdas 
na tela e na impressora. Muito do que sera visto adiante se aplica a ambas. Aquilo que se aplicar 
apenas a video sera devidamente indicado. Se houver interesse em programar saidas por impres- 
sora, devem ser lidas as orientacdes especificas, no final deste capitulo. 

Programar a saida de dados é mais simples que a entrada, desde que nao é necessario se preo- 
cupar com a interacdo com o operador. Deve-se tornar a informacdao facil de ser usada, e nada mais. 
Aqui estado algumas poucas regras para seguir: 


1. 
2: 


Evite concentrar muita informacao dentro de um espaco. pequeno. 


Se ndimeros ou letras forem listados em colunas, alinhe os dados de forma que o olho 
possa varrer a coluna com facilidade. 


. Use video reverso para salientar informacdes chaves, cabecalhos em cima e ao lado (ape- 


nas para video). 


Abaixo estado dicas que ajudarao a evitar erros desnecessarios na programacao de saida de 


dados: 


1s 


Lembre-se de seguir cada item numa declaracao PRINT com um ponto-e-virgula, a menos 
que se deseja espacamento em colunas. Este é 0 erro mais comum nas declaracoes de sa/da. 


Antes de fazer qualquer coisa, projete sua tela ou relatorio. Use uma folha de papel para 
graficos ou um formuldrio feito especialmente para projetos de relatorio. O Apéndice L 
tem uma tela que permite calcular linhas e colunas com precisdo. A alternativa para isso 
é Oo método de tentativa e erro, que no fim faz perder muito mais tempo que se o formu- 
lario for projetado antecipadamente. 


. Procure subscrever arranjos que nao se dividam em colunas pares. Por exemplo, suponha 


que se tem 25 itens num arranjo N$(I) que serao colocados em trés colunas. Pode-se ser 
tentado a fazer algo como abaixo: 


100 FOR | = 1 TO 25 STEP 3 
200 REM PROCESSO DA COLUNA 1 


300 REM PROCESSO DA COLUNA 2 


400 REM PROCESSO DA COLUNA 3 


500 NEXT | 
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Mas na passagem final do loop FOR-NEXT, os fndices 26 e 27 seréo computados, 
embora nao existam. Pode-se facilmente testar o fim do arranjo num loop FOR-NEXT, 
como abaixo: 


100 FOR | = 1 TO MX STEP ST 


350 |=I1+ 1 
360 IF | > MX THEN 510 


500 NEXT 
510 REM CONTINUA O PROGRAMA 


A Tela Como Janela de Dados 


Quando se lida com grande quantidade de dados, uma técnica muito comum é a de se usar a tela 
como uma janela de dados. Durante todo o tempo o video mostra apenas uma parte dos dados 
existentes. Uma forma de fazer isso 6 agrupar os dados em paginas, cada uma cabendo na tela. 
Os programas que usam essa técnica devem ter rotinas especiais para mostrar o cabecalho e os 
valores dos dados em cada pagina. Deve haver também alguma forma do programa mudar de uma 
pagina para a outra. 

E muito comum os arranjos guardarem grandes quantidades de dados. Nesse caso, pode-se 
usar a tela como o visor de uma camara. Imagine que o arranjo de dados é escrito numa grande area 
e@ pode-se observar esta drea através de uma camara. A area é tao grande que nao se pode observar 
todo o espaco pela camara de uma sO vez, porém pode-se ver partes pelo movimento da camara 
para cima, baixo, direita e esquerda. A tela pode imitar isso. 

Vamos ilustrar o uso da tela como janela de dados criando um exemplo no Applesoft da 
janela acima descrita. De inicio, vamos criar um arranjo inteiro em duas dimensdes. Como valor 
para cada elemento do arranjo, associaremos numeros de 4 digitos que identifica os indices, como 
segue: 


X%(i, /) =0/0/ 
Por exemplo: 


X% (3, 2) = 0302 
X% (19,8) = 1908 
X% (11,12) = 1112 


Pode-se inicializar este arranjo inteiro de forma simples, como segue: 
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1O DIM X4614-50) 

20 FOR IT = 41 TO 14 

os FOR J = 4 TO SO 

40 KMACI+J) = IT * 100 + J 
20 NEXT J 

40 NEAT I 


Agora vamos mostrar uma parte deste arranjo. Usaremos as duas linhas superiores da tela 
para cabecalho e os primeiros nove espacos de cada linha para cabecalho lateral, como abaixo: 










AHHH Het te te 










|| | | dix? | Tt tT TT ttt Te 
Lt IN tt Oe 
N Lt ot ea 
| Y ERR Sees fee etal Me 
pelt ileal ei Te te | 
| feliiniHial tyiy} | Hipp bt Re ee 
Lea Pe PP re ee 
| fetrintutal Tyivi | PT PET TTT TT TEE TT TE EET 
LAG Nei Pee EE 
pelea aL vive PTE PT PPT 
ea yey 
Tl ee eT Eee 
peda SE ee eS 
red he ete 
ge ea 
ee ee 
teh pe EE) | fT 
te a a 
Tne eee ae 
ep EP eR tH 
et EEE HH 
Ee a ee ee 


O ndmero atual da coluna vai aparecer onde se vé o XX acima. O numero atual da linha vai 
aparecer onde se vé YY. Aqui esta o programa necessdrio para criar cabecalhos de linhas e colunas 
em video reverso: 


1000 INVERSE 

1020 FOR [T = 1 TO 3 

1030 HTAB 4 + YT * 10° PRINT “COLUNA™;: 

1040 WEXT I 

4030 PRINT 

1060 FOR —T = 0 TO 2 

4065 REM 1 ESPACO EXTRA ANTES DO PRIMETRO DIGIC. 
4070 GE = D5 IF Ce * F * 40 FHEN BA = 1 

‘60 HIAB t@ + 2 *® 4108 PRINT EPECS.IZEA + TS 

10S0 WEAT 1 
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1100 PRINT 

1110 FOR T = RE TO RK + 9 

1149 REM 1 ESPACO EXTRA ANTES DO PRIMEIRO DIGITOS. 
420 92 = 0: If I < 10 THEN S% = 4 

420 HTAB @: PRINT “LINHA’S: HTAB Gt PRINT SPOCS%)s1 
140 NEXT I 

1986 NORMAL: RETURN 


Criamos deliberadamente uma janela que € menor do que a tela de forma a ficar melhor 
ilustrado o conceito de janela de dados. Nao ha nada que impeca que se crie uma janela que ocupe 
toda a tela; porém haverd ocasides em que se deseje uma janela pequena de forma que outros 
dados aparecam concorrentemente no video. 

Adicionaremos agora instrucGes para pedir ao operador dois numeros representando a menor 
linha e a menor coluna do arranjo. O elemento do arranjo com esta linha e coluna aparecera no 
alto a esquerda da tela. Os elementos adjacentes a este aparecerdo de forma a preencher toda a 
janela. Aqui esta o programa inteiro: 


— REM JANELA MUM PROGRAMA DE MOSTRAR TABELA 

Hy ROR MMe ae ee FM ee Se 3G HEHE 9G FEE EH HE EEF SE 9 HE HG HE GE I HE 
10 HOME: PRINT “ESPERE, PROCESSO DE INICTALIZACAO’; 
a) DIM X4614-50) 

a FOR I = 4 TO 144 

Sf) FOR wo= 7 TO SO 

“0 BACIsJ2 = IT # 700 + J 
Of NEXT J 

7Q WEXT I 

fot hOME 

mY HARB Ts UVTAB 205 TNPUT “ENTRE COLUNA ¢4 A Tepes 
7 26 / Cs 4 4 OK CA * Ye THEN GOTO 80 

YOO TAB a 2 INPUT “ENTRE LINHA C1 A 4187S Re 

T40 IF RA < 4% OR RX } 4T THEN GOTO 700 

T20 VAR ds HAG 1: GBOSUB TOO0O" REM MOSTRA CABECALHOS 
120 REM PREEACHE UALOGRES DA JANELA 

igo UTTAR 3 

Tel; FOR 224 TO RA + & 


: Cx TO CZ + 2 
“M MOSTRA VALORES DA JANELA ALINHADOS A DIREITA 
BOXK (CS, D038 PRINT SPOC1O-LENCK#) 09X83 


 & 


fs REM PROZXIMA LINHA 


me. US: TF 06 4) “S" AND Ut 47 “N* THEN 220 


210 VTAB 22: PRINT “CONTINUA? ENTRA $ OU NE*3 
GE 
239 IF Of = “€" THEN GOTO 80 

: 
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990 REM 

994 REM ++44+444+44444 SUBROTING 1Q00 +4+4+4+444+ 44445444 
992 REM SAI CABECALHOS DE LINHAS E COLUNAS 

1000 INVERSE 

1020 FOR I = 1 To 3 

1030 HTAB 4 + I * 10: PRINT “COLUNA’S 

1040 NEXT I 

1050 PRINT 

1060 FOR T = 0 To 2 

1065 REM 1 ESPACO EXTRA ANTES DOS NUMEROS DE 4 PIGITO 
1070 S% = O: IF C% + 1 ¢ 49 THEN 5% = 4 
1080 HTAB 16 + I * 102 PRINT SPOCS%)30% 4 
1090 NEXT I 

1100 PRINT 

14410 FOR I = RX TO RK + 9 

1415 REM 1 ESPACO EXTRA ANTES DOS NUMEROS DE 4 DIGITS 
1120 S$% = O: IF I < 10 THEN S% = 1 

141430 HTAB 2: PRINT “LINHA’$: HTAB &2 PRINT SPOCS%31 
1140 NEXT I 

41450 NORMAL! RETURN 


ot 
“—=2 


Coloque este programa no computador e execute-o. Se tudo for executado corretamente, 
a primeira coisa que acontecera é o computador parar por instantes; ele estarad rodando a rotina 
FOR-NEXT aninhada das linhas 30 até 70. Sao gastos de 5 a 10 segundos para preencher o arranjo 
X% com numeros. O programa da uma mensagem de adverténcia sobre isso. Sem tal mensagem, 
© operador poderia pensar que o computador nao esté operando. E sempre bom dar tais mensagens 
quando o sistema fica parado por um intervalo de tempo consideravel. 

Veja que sdo permitidas as colunas de numero 1 até 12. Existem trés colunas, embora qual- 
quer coluna de numero maior que 12 ficara dentro do arranjo de 14 colunas. Linhas de numero 
1 a 41 sdo permitidas, desde que o numero de linhas iniciando em 41 atingiriam 50, que é a outra 
dimensdao do arranjo. 

O valor inteiro do arranjo X% é convertido para cordao na linha 170, antes de ser mostrado. 
Fizemos a conversdo para simplificar a formatacao de safda. Assim fica facil de calcular o numero 
de espacos entre colunas, como mostrado pela declaracdo PRINT na linha 170. Nao é tao facil 
alinhar valores numéricos corretamente quando sao impressos diretamente. Para ver isso, troque o 
contetido da linha 170 por: 


170 PRINT SPC (7); X% (J, 1); 


Os numeros serao alinhados nao permitindo mostrar nimeros de quatro digitos — tornando o 
comando de impressao muito grande para uma tela de 40 caracteres. 

Nosso programa toma bastante cuidado para terminar a saida na 398 coluna do video, ao 
invés de na 404 e Ultima. Se forem colocados caracteres na 408 coluna, aciona-se 0 mecanismo 
automatico de salto de linha para continuar na proxima. Deve-se evitar o conflito entre os retornos 
devidos ao processo automatico € os devido ao programa. 

Como exercicio, seria interessante modificar o programa de mostrar a tabela de forma a 
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fazer com que passe da 404 coluna. Para fazer isso deve-se trocar a tabulacdo da linha 150 de 10 
para 11, na linha 1030 de 4+1*10 para 5+1*10, na linha 1080 de 18+1*10 para 19+1*10 e 
finalmente na linha 1130 de 4 e 5 para 5 e 9. Tente rodar agora o programa; as colunas de nimeros 
aumentaram, porém ha muitos retornos e os numeros das colunas no cabecalho do alto sao cober- 
tos pela primeira linha dos valores do arranjo. Veja se é possivel eliminar os retornos extras e gerar 
a tela corretamente. Essa nado é uma tarefa facil. 

Veja que as declaracdes que pedem dados nas linhas 80, 100 e 220 sao seguidas por passos 
de programa que impossibilitam digitacdo de dados invalidos. Mesmo num programa de demons- 
tracdo perdemos tempo para criarmos rotinas de seguranca na entrada de dados. 

Um refinamento Util para o programa é a possibilidade de dar ao operador a chance de 
mover a janela para cima e para baixo, ou para a direita e esquerda. Isso é facil. Usaremos as teclas 
|, J, K e M para direcionar o controle de forma semelhante aquela usada na edi¢do (descrita no 
Capitulo 3). A tecla | move uma linha para cima. M desce uma linha, J move uma coluna para a 
esquerda e K uma coluna para a direita como mostrado a seguir: 








Para fazer esta tarefa precisamos trocar as linhas 210 a 240 com as seguintes declaracées: 


10 UTAB Ba: PRINT “CONTINUA?” 
ets PRINT “ENTRE DIRECAQ (1,J,K-M)-5 QU N “3 


yee 
(Cee tee } 
oa “+ Ee 

5 Ee tok 


yey 
teen 220} 

3 fT oS 
ee: vot 


fT) 


ot hy 9 


an te 


ey er) ey 
ety 


we & } 
ae tj 
20 
tess 
2e0 


GET C¢ 

REM ABALXO UMA LINHA ? 
TF R% > 4 THEN IF C# = “M* THEN RX = RX - 4: GOTO 4120 
REM SORE UMA LINHA ? 

IF RX < 44 THEN IF C# = “J" THEN CX = 0% ~ 42 GoTo 120 
REM ESQUERDA UMA COLUNA 7 

IF C% > 4 THEN TF C# = “J” THEN CX = €% = 13 GOTO 120 
REM DIREITA UMA COLUNA ? 

IF CX < 42 THEN IF CX = “K” THEN CX = O% + 42 GoTo 120 
IF C$ = “S" THEN GOTO 90: REM ENTRA NOVA LINHA E COLUNA 
LF C# = “N" THEN END 
REM TOCA O SINO (BELL: 


> & REJEL TA OUTRA LETRA 
PEINT CHR#<¢7 25s GOTO 220 
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Veja como a ldégica é direta, mesmo testando erros de digitacao. Qualquer digitacao dife- 
rente da permitida é rejeitada, e o caractere de controle direcional é rejeitado se mover a janela 
além dos limites do arranjo. 


PROGRAMANDO IMPRESSORAS 


O Apple II trata a impressora como substituta da tela de video. Para criar safda por impressora, 
devem-se dar declaragdes de programa que desviem a safda do video para a impressora. Os coman- 
dos devem trazer de volta a safda para o video, quando for terminada a impressdo. Isso é feito 
usando a declaracdo PR#. 

As impressoras se ligam ao computador por meio de uma interface serial ou paralela, depen- 
dendo do modelo usado. 

Normalmente o cartdo de interface serial 6 conectado ao slot 1 do Apple || enquanto a inter- 
face paralela é colocada no slot 2. Mas isso é mais convencado do que necessidade. De fato, os 
cart6es de interface serial e paralela podem ser inseridos em qualquer um dos slots (exceto o 
slot 0). 


Saindo Texto para a Impressora 


Lembre-se que o PR#é considerado uma declarac¢do do DOS sempre que o DOS esta presente. Isso 
significa que ele deve ser impresso com um Caractere pré-fixado, o CTRL-D (cddigo 4 em ASCII). 
O programa abaixo imprime duas linhas de texto numa impressora conectada no slot 1 do Apple II 
com o DOS presente: 


10 REM MANDA DUAS LINHAS DE TEXTO PARA IMPRESSORA 

es REM CRIA O CARACTERE CTRL-D 

30 DS = 7" 

40. REM SELECTA ©O PORT SERTAL DE E/S5 

~Q PRINT D&s "PRET" 

60 PRINT “O APPLE ESCREVE FARA A TELA OU IMPRESSORA” 
7QO PRINT "E EM CADA CASO SAI UM BYTE POR VEZ” 

BO REM DESCONECTA A IMPRESSORA 

QO PRINT D&? "PERO" 

TOO ENB 


A declaracao na linha 30 cria o caractere de controle que converte o comando PR#¥ na declaracdo 
BASIC. A declaragdéo PR# aparece nas linhas 50 e 90. A declaracdo na linha 50 transfere a safda 
da tela para a impressora, enquanto que a da linha 90 transfere de volta para a tela. A declaracao 
PRINT das linhas 60 e 70 manda duas linhas de texto para a impressora. Aqui esta o resultado 
obtido quando se roda o programa: 


O APPLE ESCREVE PARA A TELA OU TMPRESSORA 
E EM CADA CASO SAL UM BYTE POR VEZ 
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Aqui esta o mesmo programa para o Apple II sem o DOS: 


40 
4&{) 
3G 
&() 
70 
80 
oO 
400 


REM SAIDA DE BUAS LINHAS DE TEXTO PARA IMPRESSORA 
REM SELECIONA O PORT DE E/S 

PRINT “PRH1” 

PRINT “O APPLE ESCREVE PARA A TELA OU IMPRESSORA” 
PRINT “E EM CADA CASO SAL UM BYTE POR VEZ~ 

REM DESELECTA A IMPRESSORA 

PRINT “PRO” 

END 


Impressoras Programaveis 


Muitas impressoras permitem que a saida seja formatada sob controle do programa. Inserindo os 
caracteres de controle apropriados no texto que sai pela impressora, pode-se ajustar a largura de 
linha, 0 Conjunto de caracteres, o tamanho da pagina e uma grande variedade de outras carac- 
teristicas. 


Muitas impressoras populares sdo comumente usadas com o Apple II. Sob o ponto de vista 


de programacao, entretanto, o Apple II trata todas as impressoras de forma idéntica. Por exemplo, 
suponha a impressora da Texas Instruments modelo 810 conectada a um computador Apple I! 
por meio de uma interface serial conectada ao slot 1. O manual da Texas diz que podemos deter- 
minar o tamanho da pagina para seis linhas em cada uma com a seguinte seqiéncia de caracteres: 


Esc-2 Crrat-l RETURN 
—— 


Caractere de término 


Tamanho de pagina: seis linhas de texto 
mais trés de cabecalho 


Este caractere diz que se segue a definicao 
de formato de pagina 


Além disso, pode-se forcar a impressora a pular para o inicio da pagina seguinte (esta operacdo é 
conhecida em computa¢ao como /ine-feed) com a seguinte sequéncia de caracteres: 


Crr_-R RETURN 
— 


Caractere de término 


Este caractere diz a impressora para pular 
para a pagina seguinte 


Modificando o nosso exemplo anterior, a listagem para o Applesoft abaixo faz a impressao 


das mesmas duas linhas 15 vezes, em blocos de & linhas. Este programa deve ser usado com a pre- 
senca do DOS. 
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10 REM SAIDA DE TEXTO PARA A TMPRESSORA 

11 REM USANDO 4&4 LINHAS POR PAGINA E S FPAGINAS 
2Q0 REM CRIAR O CARACTERE CTRL-D 

30 DS =" 

40 REM SELECIONA O PORT DE E/S SERTAL 

20 PRINT DG? “PRAT” 

31 REM DETERMINA 6&6 LINHAS POR PAGINA 

ue PRINT CHRS (e7>93°2"°: CHRS ¢€6) 

Jo PRINT CHR (12)35 REM SAL FORM FEED PARA POSTICTIONAR 

PARA O INICIO DA IMPRESSAO 

o& FOR IT = 4 TO 45 

60 PRINT “O APPLE ESCREVE PARA A TELA OU IMPRESSORA” 
70 PRINT “E EM CADA CASO SAI UM BYTE POR VEZ” 

fo WEXT I 

BO REM DESCONECTA A TMPRESSORA 

SOQ PRINT D&s"PRRO” 
100 END 


No programa acima, a declaracéo da linha 52 seleciona seis linhas por pagina. A func¢do 
CHR$(27) representa o caractere ESC. O CHR$(9) define a pagina como sendo seis linhas mais 
trés de separacao entre o fim de uma pagina e o inicio da outra. Os pontos-e-virgulas concatenam 
todos os caracteres de forma a dar a sequiéncia requerida pela impressora. 

A declaracdo da linha 53 executa o salto para o inicio de uma pagina. O CHR$(12) executa 
a funcdo form feed. Um ponto-e-virgula segue o caractere de form feed porque sem ele a declara- 
cao PRINT produziria um carriage return, resultando numa linha em branco. Sem o ponto-e-vir- 
gula, entretanto, a primeira pagina teria uma linha em branco e cinco linhas impressas, enquanto 
as demais teriam seis linhas impressas por pagina. 

Qualquer outra impressora programavel pode ser conduzida transferindo-se para ela os cdd/- 
gos de controle da mesma forma. 

Este programa nao opera em Integer BASIC porque usa a funcdo CHR$. No entanto, pode-se 
gerar qualquer caractere ou seqUéncia de caracteres acionando combinacoes de teclas. Pode-se 
trocar o CHR$ por um par de aspas fechando um caractere que nao é impresso. Por exemplo, o 
valor gerado pela digitacao (com trés teclas) do “Esc’’ 6 o mesmo que CHR$(27). Veja o Apéndice 
| onde ha uma listagem completa de tais equivaléncias. 


Imprimindo Listagens de Programa 


Digitando-se o comando LIST no teclado, qualquer programa do Apple I! pode ser listado na tela 
do video. Para imprimir a listagem, entretanto, deve-se dar os comandos PR# apropriados antes e 
depois de dar 0 comando LIST. Assumindo que a impressora esta conectada a uma interface no 
slot 1, aqui esto os passos necessarios: 


1. Certifique-se que o programa a ser listado esta na memoria do Apple II. 


2. Com o cursor numa linha em branco, selecione a impressora com o comando PR#1. O 
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cursor voltara para o primeiro caractere da linha corrente porém sem passar para a linha 
de baixo. 


3. Digite LIST. Este comando nao aparecera na tela, porém sera colocado na impressora 
onde o programa também deverda aparecer listado depois. 


4. Quando o programa inteiro estiver listado, devolva a impressao para o video com a digi- 
tacdo de PR#0. Este comando nao aparecerd no video; deverd aparecer na impressora. 


GUARDANDO DADOS EM CASSETTE 


Aprendemos no ultimo capitulo como guardar e recuperar programas guardados numa fita cassette. 
No Applesoft, pode-se também guardar valores numéricos ou arranjos inteiros na fita. 


A instrucdéo STORE guarda valores de arranjos e a instrugdo RECALL os |é de volta. Ne- 


nhum dos dois controla os movimentos do gravador, nem apresenta diretivas dizendo ao operador 
quando operar os botdes do gravador cassette. O programa abaixo demonstra o uso do STORE e 
RECALL. Ele atribui valores a um arranjo numérico, guarda o arranjo numa fita cassette, coloca 
os valores do arranjo em zero e, finalmente, relé os valores da fita. Os valores do arranjo sdo mos- 
trados em pontos-chave para documentar as mudangas que vao ocorrendo no decorrer do programa. 


VO) 
=O 
oC) 
{J 
18) 


Taew Saw 


REM ESTE PROGRAMA DEMONSTRA ©O STORE E O RECALL 
FOES M36 RE Ge 26 36 FC FE HEHE RE IG HE KM KMRL AKG KAKU MAKAAKAH KK HH 
DIM ACTO} 
HOME. 
PRINT TAB ¢€4)3"°GUARDOUs TAB (1395 °LUMPOU"? TAR (229; 
“RELEU” 
REM INICTALIZA VALORES CO ARRANJIO 
FOR To = 4 £O 108 ACT) = Tt NEXT I 
fo= 8: GOSUB TODO: REM MOSTRA VALORES A GUARDAR 
VTAB 2O5 HTAB 4 
FRINT “COLOQUE Oo CASSETTE NO GRAVADOR.REBOB INE” 
PRINT “ACTIONE OS BOTOES *RECORD*® & *PLAY"” 
IWFUT "E DIG gLTE "VAL*® “CS 
TF CE 4 } “VAI” GOTO 270 
STORE A 
MLEARS REM CO 
VTAB 2t To = 4 


LOCA VALORES DO ARRAMNJIO A ZERO 
= 76: GOSUB T0005 REM MOSTRA ARRANIO LIMPO 
VTAR Ot HTAB 14 
HBOSUB TIDOs REM LIMPA ULTIMAS INSTRUCOES 
VTAB 20: HTAB +4 
PRINT “REBOBINE A FITA. ACTONE "PLAY, 
INPUT “E D I GITE "VAT? "sC¢ 
IF CS < + “VAI” GOTO 200 
RECALL A 
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eoQO VTAB 2: T = 26: GOSUB 10002 REM MOSTRA VALORES LIDOS 
270 GOSUB 1100: REM LIMPA ULTIMAS INSTRUCOES 

2600 YTAB 20: HTAB 1 

70 PRINT "ACIONE ’STOP’.* 

200 END 

SPO REM +4+4+4444444444+ SUBROTINA 1000 4444444444444 4444 
1000 FOR T = 71 TO 102 HTAB T? PRINT ACTO® NEXT Tt RETURN 
1090 REM 4444444444444 SUBROTINA 1100 +4+444+4+44444444444 
1100 FOR LT = 1 70 119% PRINT “~ “$5 NEXT It RETURN 


Pode-se guardar um arranjo sob o nome de uma varidvel e chama-lo usando outro nome. 
Mas, de forma geral, a dimensao de um arranjo gravado deve ser a mesma do arranjo usado na 
leitura. Existem alguns casos excepcionais mais complicados que sdo vistos no Capitulo 8. A menos 
que haja inten¢ao de obter algum efeito especial, use o RECALL para os dados gravados no cassette 
com um arranjo das mesmas dimens6es daquele utilizado no STORE. 


OTIMIZACAO DE PROGRAMAS 


Tradicionalmente, 0 programa é6timo é aquele que, para uma dada tarefa, opera mais rapidamente 
e usa menos memoria. Claramente estes dois objetivos devem ser balanceados de forma que o pro- 
grama resultante seja eficiente, facil de escrever, facil de usar e facil de modificar. Havera mais 
beneficios ao longo do tempo em se direcionar a programacao sobre esses aspectos do que ficar 
praticando malabarismos para otimizar a velocidade e a utilizacdo da memoria. Em tempo, se ja 
houver o conhecimento de como otimizar a velocidade de programas e a utilizacdo da memoria, 
deve-se inicialmente escrever programas que sejam eficientes e que nao precisem ajustes finos de- 
pois de estarem rodando. Neste espirito, apresentamos algumas formas de escrever programas que 
sao mais rapidas e usam menos meméOria. 

Algumas das técnicas para fazer um programa rodar mais rapido fazem-no consumir mais 
espaco, enquanto outras técnicas que economizam espaco em memoria, aumentam o tempo de 
execucdo. Deve-se decidir o que é mais importante em cada programa individualmente. 


PROGRAMAS RAPIDOS 


Evite usar constantes (ou seja, 0, 100, ““Y’’, ‘““ENTRE’’). No lugar delas, associe primeiramente em 
seu programa o valor da constante na varidvel. Use entdo a variavel onde se usaria a constante. 
Isso 6 especialmente importante quando se usam constantes inteiras repetidamente em expresses 
reais. Leva muito tempo para se converter uma constante para um valor real porque é preciso 
varrer a tabela de varidveis. E quando tal conversdo acontece dentro de um loop FOR-NEXT, uma 
sub-rotina muito usada ou uma funcao definida pelo usuario, as diferencas se tornam muito mais 
significativas. Esta técnica tem como beneficio adicional o fato de tornar o programa facil de ser 
alterado. Se for necessdria sempre a troca de uma constante, sera mais facil modificar aquela 
dentro de uma declaracao de atribuicado, do que procurar e trocar cada ocorréncia da constante 
ao longo do programa. 
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Use aquelas varidveis mais freqiientemente usadas no programa tao proximas da execu¢ao 
quanto for possivel. A alocacéo de varidveis se da de forma que a primeira varidavel que chega é 
alocada primeiro, e na medida em que elas chegam, vao sendo alocadas em seqiiéncia. O BASIC 
encontra uma variavel no inicio da lista mais rapidamente que uma no fim dela. 

Quando o BASIC encontra uma declaracao de salto para uma outra linha, ele comeca a 
procurar o endereco a partir do inicio do programa e vai pesquisando até encontra-lo. Claramente, 
quanto menor for o nimero da linha em relacdo as demais linhas do programa, tanto mais rapido o 
BASIC executa a instrucdo. Por isso, em seus programas, dé enderecos baixos para as sub-rotinas 
de uso mais frequente. 

No Applesoft, nado inclua indices na declaragdo NEXT. Dessa forma, evita-se a necessidade 
do programa conferir se o fndice foi especificado corretamente ou nao. 


PROGRAMAS COMPACTOS 


Use sub-rotinas para evitar duplicacdo de programa para a mesma ldgica. Essa também sera uma 
forma de aumentar a legibilidade, eficiéncia e facilidade de alteracdo de seu programa. 

Use os elementos de indice 0 dos arranjos (ex. X(0), B(0)). 

Existem menos caracteres num nome de varidvel pequena que numa constante de varios 
digitos. Por isso atribua nomes de varidveis a constantes e use esses nomes ao invés de especificar os 
valores reais. 

Ponha mais de uma declaracdo numa mesma linha. Cada nova linha de programa usa cinco 
bytes extra para seu numero. Observe, entretanto, que as linhas de programa compostas de mais de 
uma declaracdo so mais dificeis de editar e também de ler e entender. Conceber como o programa 
deve operar pela primeira vez é dificil, pior ainda é ter que fazer isso muitas vezes, mais tarde. 

Use declaracdes REM com critério; abrevie os comentarios. Mas seja cuidadoso; quanto me- 
nos comentarios seu programa tiver, mais dificil sera destrincha-lo mais tarde. 

Seja econdmico com o uso de variadveis. Cada uma delas requer uma certa quantidade de me- 
moria, mesmo se for usada apenas uma vez. Crie um sistema de criacdo de nomes de variaveis, que 
tenha algumas do tipo rascunho, que podem ser usadas dentro de loops FOR-NEXT, calculos 
intermedidrios, e coisas do tipo. Porém nao se exceda; o programa ficara mais facil de ser enten- 
dido se os nomes forem escolhidos com critério e significado. Crie padrdes de identificacdo para 
cada variadvel (por exemplo, NC$ para nome do cliente) e para tipos de varidveis (por exemplo, 
todas as varidveis de rascunho iniciam com a letra X). 

Use declaracdo INPUT e arquivos de dados (se tiver um disco, veja o Capitulo 5) em vez de 
declaracoes de atribuicao e declaracdo DATA. 

No Applesoft, use arranjos inteiros no lugar de arranjos reais. Cada valor no arranjo inteiro 
usa dois bytes de memoria, enquanto que cada valor no arranjo real usa cinco bytes. Use a fun¢ao 
FRE periodicamente no seu programa para limpar dreas de armazenamento de corddes na meméoria. 


DEPURAGAO 


Um programa novo nunca funciona segundo se espera que ele funcione. Mesmo se nao houver 
erros de sintaxe BASIC, 6 comum o aparecimento de erros na légica usada. Em “‘computés’’ 
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chama-se a qualquer um dos dois tipos de erro de bug. O processo para deteccdo e correcdo é 
conhecido como debugging. Existem varias formas de se depurar (ou fazer o debugging) do pro- 
grama. 

Existe uma forma de conduta sempre recomendavel: tome seu tempo, planeje o que fazer, 
faga-o corretamente na primeira vez. Nao se sente em frente ao teclado com um mero esboco do 
que deve ser feito, entrando com o programa ‘‘na raca’’. Se lhe faltar experiéncia em programacao, 
complemente esta literatura com uma de diretivas do BASIC listadas no Apéndice K para ter algu- 
mas nocoes praticas de como se deve programar bem. 

Se seu programa foi escrito e nado esta operando como foi imaginado que fizesse, existem 
algumas declaracdes do BASIC que podem ser usadas para ajudar na depuracao. 


A Declaragao PRINT 


Surpreendentemente, a velha e conhecida declaracdo PRINT é uma excelente ferramenta de depu- 
rag¢ao. Pode-se acrescentar algumas declaracdes PRINT de forma temporaria em pontos estraté- 
gicos do programa para mostrar mensagens que informem se o programa atingiu determinados 
pontos sem falha, e informar valores intermedidrios de variaveis. Essa 6 uma forma de acompanhar 
o fluxo da execucao do programa e verificar os resultados de calculos de valores intermediarios. 


A Deciaragao TRACE 


A declaragdo TRACE, como seu nome indica, traca o fluxo da execucdo do programa mostrando 
o numero da linha de cada declaracdo que executa. Para ver como ela funciona, digite o programa 
abaixo, digitando em seguida o comando TRACE seguido por RUN. 


700 PRINT “ENTREE UM NUMERO DE 1 4 & ¢& PaRA FIM”? 
110 INPUT N 

t20 IF N= 4 THEN PRINT “ONE” 

130 IF N = 2 THEN PRINT “TWO” 

T40 UF N = 2 THEN PRINT “THREE” 

150 IF N = 4 THEN PRINT “FOUR” 

140 IF Noe & THEN PRINT “PIVE” 

170 IF N > S&S THEN GOTO 100 

180 FOR T = 41 TO N 

470 PRINT “8°35 REM IMPRIME N ASTERIGCOS 
eQOQ NEXT I 

210 CALL -9346: REM LIMPA A TELA 

220 GOTO 100 


Para cancelar o modo TRACE e retornar ao normal, execute o comando NO TRACE. 


A Declaragao DSP 


Existe outra declaracdo de depuragdo Util disponivel apenas no Integer BASIC: a declaracado 
DSP. Aqui esta um exemplo: 
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D1 DSP CONTA 


Uma vez que essa declaracao DSP particular tenha sido executada, o Apple I! informara cada vez 
que o valor da varidvel CONTA mudar, e em que linha ocorreu tal mudanca. Como o comando 
RUN desliga as declaracdes DSP dadas previamente, deve-se dar GOTO para iniciar 0 programa, 
ou colocar o DSP como declaracao dentro do programa. 

Para se desativar o modo DSP para uma variadvel deve-se dar a declaracao NODSP. Aqui 
esta um exemplo: 


$300 NODSP NOMES 


Uma vez executada esta declaracdo, o Apple || nado mais notifica cada alteracdo da variavel NOMES. 
Tente adicionar as linhas sequintes no exemplo usado para o TRACE para observar o efeito 
do DSP. Embora se possa usar ambos simultaneamente, tente rodar o exemplo sem o TRACE para 
ver mais claramente os efeitos do DSP. 
{O OSPH 
20 DSP I 
400 PRIN “ENTREE UM NUMERO DE 1 A S (6 PARA FIMO": 
: q i LMFT 
wl) TF &® = 4 THEN PRINT “ONE” 
ne) lf Ses @ THEN PRINT “THO” 
ae Lf = 3 FHEMN PRINT *TLHREE” 
2) If N= 4& THEN PRINT “POUR” 
£0 lr? Ne & FHEN PRINT “FIVE” 
eG {F WN * & THEN GOTO 400 
4650 FOR £ = 4 TO W 
190 PRINT “a°ss REM IMPEIME NM ASTERTSCOS 
200 NEXT I 
21S NOUSP 
210 CALL ~936: REM LIMPA A TELA 
eeu GOTO +00 


43 
4g 
5 
Vé 


RESTRICOES NO MODO IMEDIATO E PROGRAMADO 


Pode-se usar a maioria das declaracdes BASIC em ambos os modos. Porém ha declaracdes que sao 
legais apenas em modo programado, e outras apenas em modo imediato. A Tabela 4.2 lista as 
declarac6es restritas para o Integer BASIC. A Tabela 4.3 lista as declarac6es restritas para o Apple- 
soft. 
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TABELA 4.2. Declaracdes Restritas a Modo Programado ou 
Imediato no Integer BASIC. 


Modo Programado Modo Imediato 


END 
FOR 
GOSUB 
INPUT 
NEXT 


RETURN 





TABELA 4.3. Declaracdes Restritas a Modo Programado no Applesoft. 


Apenas em Modo Programado 





DATA 
DEF FN 


GET 

INPUT 

ON ERR GOTO 
RESUME 





o 
O Disk II 


O drive de disco 6 um dos mais importantes componentes de um sistema de computacao. Ele 
permite acesso instantaneo a qualquer item de uma longa lista de informacdes. O disco do Apple I! 
pode guardar mais de 143.000 caracteres de dados num Unico disquette. Isso é quase trés vezes o 
que se pode guardar em 48K de RAM e, quando o computador é desligado, toda a informacao 
presente no disco permanece intacta. 


SOBRE DISCOS 


Os discos guardam informacdo magneticamente, da mesma forma que uma fita de gravador. A 
maior diferenca é que o disco é redondo e roda como um disco de musica. Dentro do drive existe 
uma cabeca que |é e grava informacado. O computador pode mover a cabeca para qualquer parte da 
superficie do disco. Essa habilidade permite o acesso a/eatério. Por isso, pode-se dizer que o disco 
é um dispositivo de armazenamento de acesso aleatério. Um programa especial, chamado Sistema 
Operacional do Disco (Disk Operating System ou simplesmente DOS), controla toda a operacado do 
disco. Existem varios tipos diferentes de discos. 


Discos Rigidos 


Os discos rigidos, ou duros, sdo cobertos com uma substancia magnética. Eles armazenam tipica- 
mente de 5 a 10 megabytes de dados (um megabyte é equivalente a um milhdo de bytes). Muitos 
discos rigidos sao removiveis; isto é, o disco e o drive podem-se separar, de forma que se pode 
trocar de disco. Discos rigidos custam cerca de 150 dolares cada, os drives custam de 3 a 10 mil 
ddlares. A Figura 5.1 mostra um sistema tipico de disco rigido. 
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FIGURA 5.1. Sistema Tifpico com Disco Rigido. (Cortesia de Cameo Electronics.) 


Discos Winchester 


Os drives de disco Winchester, mostrados na Figura 5.2, usam uma tecnologia especial que permite 
de seis a dez vezes mais dados em cada disco. Os discos Winchester sdo extremamente susceptiveis 
a sujeira e pO — mesmo fumaca de cigarros. E por terem a necessidade de permanecerem sempre 
limpos, sao selados dentro do drive e ndo podem ser tocados. Um sistema de disco Winchester 
custa de 2.500 a 8.000 dolares. 


Disquettes 


Os disquettes sao o tipo mais popular de disco. Cada um deles consiste num disco de vinil circular 
fechado num envelope plastico. O envelope protege o disquette contra danos durante o manuseio 
normal. O disquette roda livre dentro do envelope. As aberturas do envelope possibilitam acesso da 
cabeca a superficie do disco e fornecem uma 4rea onde o drive pode prender e rodar o disquette. 
Ele nunca deve ser retirado de seu envelope. A Figura 5.3 mostra como é o disquette fora de seu 
envelope. 

Os disquettes, também conhecidos como floppy discs, sio comuns em dois tamanhos: 8 e 
5 % de polegadas de diametro, ambos ilustrados na Figura 5.4. O Disk I! do Apple usa disquettes 
de 5% de polegadas, que também sdo chamados minidiscos ou minidisquettes. O Disk I! pode 
guardar 143.360 bytes em cada disquette. 
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FIGURA 5.2. Drive de Disco Winchester. (Cortesia de Corvus Systems, Inc.) 





FIGURA 5.3. Um Disquette Sem a Protecao do Envelope. 
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FIGURA 5.4. Disquettes de 8 e 5 1/4 de Polegadas. 


COMO OS DADOS SAO GUARDADOS NOS DISCOS 


E interessante familiarizar-se com as varias facetas do processo de armazenamento em disco. A 
informacao armazenada num disco é 0 resultado de varias acdes coordenadas. 


Trilhas 


Para achar um byte em particular, dentro de um universo de 143.360 bytes de cada disquette, 
o Apple DOS divide o disco em 35 trilhas, numeradas de 0 a 34. Essas trilhas so similares Aaquelas 
dos discos de musica, a excecao de que nao podem ser vistas e uma trilha nado se conecta com a 


Lado do disquette 
Centro do disquette 


Uma trilha na superficie 
do disquette 





FIGURA 5.5. Trilhas do Disquette. 
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seguinte, mas sim consigo mesma; isto 6, sao circulos concéntricos, um dentro do outro, como 
aparece na Figura 5.5. 


Setores 


Num passo seguinte para achar um determinado byte, o DOS divide cada trilha em 16 setores, 
como mostra a Figura 5.6. Cada setor guarda exatamente 256 bytes. Informado sobre a trilhae o 
setor de um determinado byte, o DOS tera apenas 256 bytes para procurar. Agora, acessar um byte 
em particular, ou uma série deles, é quase instantaneo. E usado todo o poder do drive de disco. 


= SS, 


Setores 


Trilhas 


56 b 
ytes de dados armazenados em um setor 





FIGURA 5.6. Superficie Gravada de um Disquette. 
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LOCALIZANDO TRILHAS E SETORES 


Achar a trilha de um disquette é facil: o drive move a cabeca até o ponto daquele disquette onde 
esta localizada a trilha, da mesma forma que se faria para localizar um disco dentro de um album. 

Achar o setor 6 um pouco mais dificil. Existem dois métodos usados para essa tarefa. Ambos 
usam um buraco de indice. Em muitos disquettes esse buraco é localizado perto do buraco central 
no centro do envelope. A medida que o disquette gira, o buraco (ou buracos) de {ndice passa(m) 
pelo buraco correspondente do envelope. Uma fonte de luz dentro do drive passa luz para um 
sensor sempre que os buracos estado alinhados. O computador sente os pulsos de luz e os setores 
sao localizados tendo como base essa informacao. 

Existem dois métodos usados para achar os setores do disquette, chamados setorizacao por 
hardware e setorizacao por software. 


Setorizagao por Hardware 


Os disquettes deste tipo tém varios buracos, como mostrado na Figura 5.7. Cada buraco indica a 
localizagado de um setor. Um buraco extra marca o local do primeiro setor. O computador acha os 
setores contando os buracos que vém depois do primeiro setor. O Disk II nado usa este método. 


Setorizagao por Software 


Os disquettes deste tipo tém apenas um buraco de indice, como mostra a Figura 5.8. Ele marca o 
primeiro setor. A localizagao dos demais setores é feita baseada no tempo de rotacdo do floppy 
disc. 

O Apple II ignora todos os buracos de tempo. Sua temporizacdo é totalmente eletrdnica, e 
nao fisica. Isso quer dizer que se pode usar tanto disquettes setorizados por hardware quanto por 
software com o Disk II. 


Setor 


Buraco de indice 





FIGURA 5.7. Disquette Setorizado por Hardware. 
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Buraco de indice 





FIGURA 5.8. Disquette Setorizado por Software. 


PROTECAO CONTRA ESCRITA 


Existe também um recorte do lado do envelope. Ele é usado para permitir ou evitar que seja gra- 
vada informacao no disquette. Em disquettes de 8 polegadas este recorte é para proteger contra 
escrita, porque 0 computador nao pode gravar num disquette se ele tiver o recorte do lado do 
envelope. Em disquettes de 5% polegadas o recorte permite gravacao porque o computador nao 
pode gravar num disquette, a menos que o recorte exista. Alguns disquettes, como os chamados 
“System Master Diskette’’, vendidos com o Apple II, sdo permanentemente protegidos. Eles 
vém sem o recorte. Os disquettes de 5'% polegadas podem ficar protegidos contra gravacdo, 
cobrindo-se 0 recorte com um pedaco de fita adesiva. A Figura 5.9 mostra esse processo. 





FIGURA 5.9. Protegendo um Disquette de 51/4” contra Gravacao. 
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O SISTEMA OPERACIONAL EM DISCO 


Todas as operacdes relacionadas com disco séo controladas por um programa especial chamado 
Disk Operating System, ou DOS. O BASIC transmite pedidos ao DOS para qualquer operacao onde 
O disco esteja envolvido. O DOS devolve o resultado ao BASIC. 


VERSOES DO DOS 


Existem atualmente varias verses do DOS. O DOS 3.3 é a mais recente. Este capitulo a descreve. 
A principal diferenca entre o DOS 3.3 e o DOS 3.2.1, a Ultima mais recente, 6 o nimero de setores: 
no DOS eram 13 por trilha e no DOS 3.3 sao 15. A Apple Computer Inc. tem um programa espe- 
cial que converte discos do DOS 3.2.1 para DOS 3.3. 


INICIALIZANDO DISCOS 


Antes que o Apple II possa usar um disquette, ele deve ser /nicializado. \nicializar um disquette é 
zerar todos os setores dele e colocar uma copia do DOS nas trilhas 0, 1 e 2. As instrucdes de inicia- 
lizacao do Disk I! serdo vistas mais tarde. 


ARQUIVOS EM DISCO 


A informacao é guardada nos disquettes, sob a forma de arquivos. Um arquivo pode ter qualquer 
tamanho desde que caiba num disquette. Todo arquivo tem um nome. Um arquivo pode guardar 
informa¢ado do tipo texto, um programa ou mesmo uma imagem de video grafico do Apple II. 
Os varios tipos de arquivo serdo vistos em detalhes mais tarde. 


DIRETORIO DO DISQUETTE 


O nome de todo arquivo é guardado no diretério do disquette. O diretdrio esta localizado na trilha 
17. A primeira entrada do diretério é no setor 15. A ultima entrada é no setor 1. O diretério tem 
espaco suficiente para guardar até 104 arquivos. 

Junto com o nome do arquivo é guardado também um céddigo indicando que tipo de dado 
ele contém, o numero de setores que ocupa e a localizacdo do setor que contém a /ista de trilhas/ 
setores do arquivo. 


LISTA DE TRILHAS/SETORES 


A lista de trilhas/setores contém pares de bytes que especificam os enderecos das trilhas e setores 
usados num arquivo. Cada par de bytes é chamado de /ink. O primeiro link numa lista de trilha/ 
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setor fornece o endereco do proximo setor usado pela lista. A lista pode ocupar tantos setores 
quanto for necessario. O segundo link é o endereco do primeiro setor usado pelo arquivo propria- 
mente dito, o terceiro link endereca o proximo setor usado pelo arquivo e assim por diante. Um 
link com zeros marca o fim da lista. 


Sobre o Processo de Armazenamento em Disco 


O DOS controla o fluxo de todos os dados de e para o disquette. Quando se grava um arquivo, 
varias coisas acontecem: 


1. O DOS procura o diretério do disquette para achar o nome do arquivo. (O nome dado ao 
programa o identifica, como veremos mais tarde.) 


2. Se o nome for achado, o DOS |é 256 bytes do setor apropriado e os guarda numa 4rea de 
memoria chamada buffer. Se o nome nao é encontrado, ou se tal setor daquele arquivo 
jamais foi gravado, o DOS enche o buffer com zeros. 


3. Até 256 bytes de dados gravados para o arquivo sao copiados da memoria para o buffer. 
Se forem copiados menos de 256 bytes, ficam os dados anteriores. 


4. Se, e somente se, forem escritos 256 bytes no buffer, o seu contetido é gravado de volta 
no setor apropriado do disquette. 


5. Este processo (passos 3 e 4) é repetido até que todos os dados gravados para o arquivo 
tenham sido copiados para o buffer e guardados no disquette. 


6. Apds a gravacdo de todos os dados no disquette, o DOS atualiza a lista de trilha/setor e 
o diretorio. 


Note que a menos que o nimero de bytes que se grava seja divisivel por 256, o Ultimo bloco 
de bytes nao caberd no buffer, e os passos 4 a 6 nunca acontecerdo. Por isso, o comando CLOSE 
do Disk II! forga os dados do buffer a serem gravados no arquivo, apds o que sao atualizados a lista 
de trilha/setor e o diretorio. Este processo é chamado fechamento do arquivo. Falhas no processo 
de fechamento de arquivos apds a colocacao de dados neles podem resultar em perda de dados. 
Feche sempre o arquivo apdés usd-lo. O comando CLOSE sera discutido em detalhes mais tarde. 


PANES EM DISCO (CRASH) 
Um dos piores erros que podem ocorrer é a chamada “‘pane’”’ no disco. Existem dois tipos de 
panes: de hardware e de software. 

Uma pane de hardware ocorre quando a superficie do disco é danificada, ou tem um defeito 
fisico, como um rasgo ou uma mancha de sujeira. Ela pode causar danos a cabeca de leitura e gra- 
vacao dentro do drive. A cabeca danificada pode, por sua vez, danificar mais discos. Por esta razao, 
sempre manipule os discos com muito cuidado. 

Uma pane de software ocorre quando a trilha de diretorio é alterada com dados incorretos. 
O que ocorre com mais frequéncia é o ndo fechamento de um arquivo apos a gravacao de algo nele, 
sendo que se coloca outro disco em seu lugar, e os arquivos do disco original sao fechados nesse 
outro disco. Para apreciar o estrago que isso causa, faca-o por conta propria. 
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CARREGAMENTO DO SISTEMA OPERACIONAL DISK II 


Para que o Apple II reconheca qualquer comando de disco, o programa especial DOS (Sistema 
Operacional do Disco) deve estar na memoria. Se houvesse muito tempo disponivel, poder-se-ia 
digita-lo no teclado. Porém existe uma forma mais facil: 6 o que se chama de fazer 0 boot do sis- 
tema; este processo consiste em ler uma copia do DOS do disco e coloca-la na memoria. 


COMO CARREGAR O SISTEMA 


Existem varias formas diferentes de carregar o DOS, dependendo da configura¢déo do computador 
usada e da linguagem usada para iniciar o carregamento. Todo o método assume que o disco esta 
colocado no DRIVE 1 e ocontrolador de disco esta no slot 6. 

Coloque o ‘’System Master Diskette’’ no drive e feche a porta. O passo sequinte depende do 
sistema usado. No fim do processo, a tela de video se parecera com uma das formas mostradas na 
Figura 2.5. 


Autostart 


O autostart 6 a forma mais facil de carregar o DOS. Como o nome diz, 0 carregamento 6 automé- 
tico. Para isso, o computador deve ter o Autostart Monitor. Pode-se saber se o computador tem o 
Autostart Monitor instalado, ligando-o com o Disk I! conectado. Se a lampada IN USE da cabine 
do disco acender e o disco rodar e gerar estalidos, ele tera o Autostart Monitor instalado. 

Para carregar o sistema com o Autostart Monitor, simplesmente ligue a chave do Apple II. 


Carregamento a Partir do Monitor 


Quando o caractere de apresentag¢ao do monitor ( * ) aparece na tela, o Monitor de Linguagem 
Assembler do Apple II estaré esperando comandos. Existem varias formas de carregar o DOS a 
partir do Monitor. 


Salto do Monitor para o “BOOT” 


Digite a letra C, seguida pelo numero do slot do drive que deve ser carregado (normalmente 6), 
dois zeros e a letra G. O comando inteiro é mostrado abaixo: 


¥{l4600G 
C600 é o endereco do programa na memoria que carrega a partir do drive do slot numero 6. G é 
© comando que transfere o controle para o programa. Acione RETURN em seguida. A lampada 
do drive deve acender e o drive emitira rufdos. 


Boot do Monitor com CTRL-K e CTRL-P 


Outros comandos no Monitor, que podem ser usados para carregar o DOS sao CTRL-K e CTRL-P. 
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Para usar estes comandos, digite o numero do slot (normalmente 6) seguido por CTRL-K ou 
CTRL-P. Tanto um quanto outro nao aparecerao na tela. 
Depois de digitar estes comandos acione a tecla RETURN. 


Carregando a Partir do Integer BASIC ou Applesoft 


Os mesmos comandos de carregamento sao reconhecidos tanto pelo Integer BASIC quanto pelo 
Applesoft. 


Carregando a Partir do BASIC Usando os Comandos PR# e IN# 


Apés o aparecimento do caractere de apresentacdo do BASIC (> para o Integer BASIC e | para 
o Applesoft), digite as palavras PR ou IN, o sinal de nimero ( #), e finalmente o nimero do slot 
onde esta o disco para o boot. O comando inteiro 6 como um dos que sequem: 


PR HS 
ou 
INRG 


Agora digite a tecla RETURN. 


Carregando a Partir do Apple Language System 


Se este sistema estiver instalado no Apple I|, os processos de carregamento acima nao se aplicam. 
Ele usa dois discos para carregar o DOS versdo 3.2.1, 3.2 e anteriores. Porém o DOS 3.3 nao 
opera como foi descrito acima. 

Para carregar o DOS 3.2.1, 3.2 e anteriores usando o Language System, coloque o disquette 
chamado “BASICS: Integer and Applesoft II’’ (fornecido com o Language System) no lugar do 
“System Master Diskette’’ descrito acima, procedendo entao de uma das formas descritas antes 
(autostart, PR#6 etc.). Apds o carregamento correto, a tela mostrara: 


INSERT BASIC DISK AND PRESS RETURN 


Isso nado é bem correto. Realmente o disquette que deve ser colocado é o DOS (0 “System Master 
Disquette’”’ funciona, ou se pode usar qualquer outro que tenha sido inicializado). Apds a colo- 
cacdo do segundo disquette e o acionamento da tecla RETURN, o carregamento sera executado 
normalmente e a tela mostraré uma das formas da Figura 2.5. 


INICIANDO COMANDOS DO DISCO 


O Sistema Operacional do Disco do Apple |! interpreta e executa comandos do disco. Muitos 
comandos permitem ou requerem pardmetros adicionais que definem mais especificamente a 
operacdo a ser executada. Alguns comandos elementares sao descritos abaixo. 
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O02 HELLO 

O33 APPLE-TREK 
O18 ANIMALS 
009 UPDATE 3.2. 
O14 CORY 

Oo? ToLoOR DEM 
OSs RRICK CLIT 


O24 SPACE WAR 

O50 THE INFINITE NO. OF MONKEYS 
O31 MOLOR SKETCH 

Of3 SUPERMATH 

O26 APPLEVISION 

O17 BIORHYTHM 

O27 PINBALL 





FIGURA 5.10. Catalogo de Disco Tipico. 


CATALOG 


O comando CATALOG lista todos os nomes dos arquivos do diretério do disquette para o dispo- 
sitivo de saida corrente, normalmente a tela. 

O CATALOG primeiro apresenta o numero de volume do disquette (NGmero de volume 
serao discutidos mais adiante). 

Para cada arquivo do disquette, o CATALOG lista o tipo de dado no arquivo, se o arquivo 
esta travado ou nao, o numero de setores que sdo ocupados pelo arquivo e seu nome. Um CATA- 
LOG tipico esté mostrado na Figura 5.10. 


Tipos de Arquivos 


O tipo de dado no arquivo é representado por uma letra que aparece na coluna mais a esquerda 
do catalogo. Os cédigos usados sao listados na Tabela 5.1. 


TABELA 5.1. Cédigo de Tipo de Arquivo em Disco. 


A Programas em Applesoft 
Arquivos em imagem bindria 





Programas em Integer BASIC 






Arquivos de texto 






Bindrio relocavel 
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Arquivos Travados 


Nao se pode gravar ou apagar um arquivo travado. O catdlogo indica o travamento precedendo 
0 tipo do arquivo com um asterisco ( * ). Se aparece um espaco em lugar do asterisco, o arquivo 
nao esta travado. Os arquivos travados sdo estudados serdo estudados mais tarde, neste capftulo. 


Nadmero de Setores 


O numero de setores que o arquivo ocupa é mostrado como um numero de trés digitos. O menor 
arquivo (vazio) tem o comprimento de um setor. Se um arquivo tiver mais que 255 setores, este 
ndmero sera zerado e reiniciado, o que nao afeta o tamanho real do arquivo. 


Nomes de Arquivos 


O Apple I! requer que se referencie cada arquivo pelo seu nome. Aqui estdo as regras que gover- 
nam os nomes que sao dados aos arquivos: 


1. Os nomes devem ter de 1 a 30 caracteres de comprimento. Caracteres em excesso sao 
desprezados. 


2. Devem comegcar por uma letra. 


3. Qualquer caractere digitado no teclado pode fazer parte do nome do arquivo, com exce- 
cao de virgulas. 


Pode-se usar caracteres que nado se imprimem (como aqueles criados com a tecla CTRL) como parte 
do nome de arquivo, porém eles nao serdo mostrados na lista do catalogo. Isso é Util quando se 
deseja que outros nao saibam o nome dos arquivos com que se esta trabalhando. (Nao se esqueca 
de que caracteres foram colocados em seu arquivo.) 


Usando o Comando CATALOG 


Para usar 0 comando CATALOG, digite-o simplesmente (apds o DOS ter sido carregado) como 
abaixo: 


CATALOG 


O resultado deve se parecer com algo mostrado na Figura 5.10. 

Se o numero de linhas do CATALOG exceder a 20, o computador mostrara as primeiras 
21 linhas, esperando entéo o acionamento de qualquer tecla (com excecdéo de RESET, CTRL e 
SHIFT); para mostrar as proximas 21. Essa pausa dé tempo para que se leiam todos os nomes dos 
arquivos antes de qualquer um deles ser jogado para fora por excesso de nomes. 


LOAD 


O comando LOAD |é um arquivo de programa do disquette para a memoria. Deve-se especificar o 
nome do arquivo a ser carregado. Este exemplo carrega o programa chamado COLOR DEMOSOFT: 
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LOAD COLOR DEMOSGFT 


Se o nome de arquivo especificado ndo estiver no diretério do disquette, aparece a mensagem 
FILE NOT FOUND. 

Se o arquivo esté no disquette, o DOS verifica o seu tipo de dado. Se nao for um arquivo de 
programa, aparece a mensagem FILE TYPE MISMATCH. 

Considerando que tudo esta certo, o LOAD zera o programa que esta presentemente na me- 
moria de leitura/escrita e copia o programa do arquivo para a memoria. Apés a volta do caractere 
de apresentacao pode-se listar, modificar ou rodar 0 novo programa carregado. 


A VERSAO EM DISCO DO COMANDO RUN 


Frequentemente apos dar-se o comando LOAD, da-se o comando RUN. Pode-se abreviar estes dois 
passos especificando o nome do arquivo com o comando RUN. O comando LOAD fica implicito, 
desde que o arquivo deve ser carregado antes que possa rodar. Aqui estado alguns exemplos: 


RUN PROGKAMAE 
RUN COLOR DEMOSOFT 
RUN TESTE MEMORTA 


ESPECIFICANDO O NUMERO DO DRIVE 


Muitos comandos do DOS permitem especificacdo do drive de disco. Sdo usados dois pardmetros 
para especificar o drive de disquette: o pardmetro Crive e o paradmetro s/ot. 

Pode-se conectar dois drives de disquette a um controlador. Para selecionar o drive, ponha 
uma virgula e D1 ou D2 no comando de disquette, como segue: 


LOAD CIMA, D2 
RUN ESTUDO;D1 
CATALOG, D2 


Depois que se usa o drive especificado uma vez, os comandos subseqientes de disco serdo 
processados sobre o mesmo drive, até que se especifique outro. O drive usado tera sempre sido 
especificado pelo comando anterior mais recente. Se nado foi usado ainda nenhum drive, o sistema 
usa o drive 1. 


ESPECIFICACAO DO SLOT 


Os cartdes de controle do Disk II sao conectados a slots dentro do Apple II. Existem oito slots 
disponiveis, porém o de numero O nao pode ser usado para controladores do Disk II. Restam sete 
slots para controladores do Disk I!. Como cada controlador pode suportar de um a dois drives, sera 
possivel um maximo de 14 drives ao Apple II. 

Se existirem mais de dois drives conectados, eles ndo poderdo ser chamados de D3 ou D4 etc. 
Em vez disso deve-se usar um outro pardmetro para especificar o controlador apropriado. Este 
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parametro 6 chamado s/ot e se usa para indicar em qual slot o controlador de disco que se deseja 
utilizar esta conectado. 

Para usar o parametro slot, coloca-se uma virgula, a letra S e o numero do slot (1-7) dos 
comandos de disco, como a seguir: 


mei CAL GG » Sos 
LOAD TRILHOS 
i! 


OS 2564 
RUN ESTOQUE. S3 


O slot usado quando se carrega o DOS torna-se o corrente. Ele sera selecionado até que outro 
seja especificado num paradmetro slot. 

Depois de usar 0 pardmetro slot uma vez, os comandos de disco subsequentes se valerao da- 
quele disquette selecionado no pardmetro até que se especifique outro. 

Pode-se usar os pardmetros drive e slot conjuntamente, no mesmo comando. Especificando 
o namero do slot de 1 a 7, eo numero do drive entre 1 e 2, referencia-se qualquer drive do Disk II 
conectado ao sistema. Os pardmetros drive e slot podem aparecer em qualquer ordem. Os dois 
comandos seguintes sao equivalentes: 


MATALGG. Das SS 


CATALOG, S5,02 


Ambos os comandos produziraéo o cataélogo do disquette no drive numero 2 do controlador insta- 
lado no slot 5. 


Problemas com o Pardmetro Slot 


Se selecionarmos um slot onde néo haja um controlador conectado, o computador travara. Ele 
ficara esperando por um controlador que nado existe para coloca-lo em uso. Para voltar com o 
programa intacto, acione RESET. Se aparecer um dos caracteres do BASIC (> ou | ), tudo estara 
bem. Se aparecer o caractere do Monitor ( * ), digite 3DOG e a tecla RETURN. Se nao funcionar, 
O programa foi perdido porque o DOS deverd ser recarregado. 


ESPECIFICACAO DE VOLUME 


Volume é outro pardmetro que pode ser especificado com qualquer comando do DOS que permita 
especificacado de slot e drive, exceto CATALOG. O volume permite certificar-se que foi colocado 
um disquette correto no drive que foi selecionado. 

O comando CATALOG ignora a referéncia de volume. Quando ele lista o diretdrio do dis- 
quette, o numero de volume do disco é o primeiro a ser listado. 

Para usar 0 parametro volume, ponha uma virgula e a letra V seguida pelo numero de volu- 
me, Como segue: 


LOAD TOTAL. V194 


Se o numero do volume especificado nado é o mesmo atribuido ao disquette quando ele foi 
inicializado, o DOS devolve a mensagem VOLUME MISMATCH. 
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O numero de volume deve estar entre 1 e 254. Se nao for especificado, ou se for selecionado 
o volume 0, 0 paradmetro volume é ignorado. 

Pode-se usar 0 parametro volume em combinacdo com o de slot ou drive, ou ambos, em qual- 
quer sequéncia. Aqui estado alguns exemplos: 


LOAD CARGA,D2,Ve4 
RUN FOLHA,S3-UT14 


MAIS COMANDOS DO DISK II 


Ja sabemos consultar o que tem num disco usando o CATALOG, sabemos carregar e executar 
programas. Vamos ver como colocar nossos proprios programas em disco, usando os comandos 
INIT, SAVE, DELETE, LOCK, RENAME e VERIFY, que serdo descritos abaixo. 


INIT 


Antes que se possa gravar algo no disquette, ele precisa ser /nicializado. Quando isso acontece, 
qualquer coisa gravada anteriormente 6 zerada, por isso deve-se ter Cuidado para n€o inicializar um 
disquette que contenha informacoes Uteis. 

O comando INIT coloca no disquette qualquer programa que esteja na memoria no momen- 
to de sua execucdo. Esse programa se tornard de saudacao, porque sera executado automatica- 
mente toda vez que se carregar o DOS a partir daquele disquette. Tais programas podem ser 
simples ou complexos, de acordo com o desejado. Por exemplo, suponha um disquette que con- 
tenha um sistema de mala direta. Poder-se-ia pensar em usar esse programa como o de saudacao. 
Dessa forma, ao se colocar o disquette no drive e carregar o DOS, pronto! O programa de mala 
direta ja sai rodando. Outro exemplo de programa de saudacao que consiste numa declaracao NEW 
seguida de uma END. Toda vez que o DOS é carregado, sera dado o caractere de entrada do 
BASIC (> ou ]}). 

Um programa de saudacao bem escrito deve dizer algo sobre o disquette. Um exemplo tipico 
pode ser visto abaixo: 


100 TEAT 

200 CALL -826 

S00 PRINT "ESTE © GO MEU PRIMETRO DIESUETTTE™ 
QQ PRINT 

SOQ PRINT “INTCTALIZADO EM 2579/53" 

600 PRINT 

700 PRINT “NUM SISTEMA DE 48K COM DOS 3.3” 
SOO END 


O nome do arquivo do programa de apresentacao deve ser especificado quando se da 0 Co- 
mando INIT. Sera necessario manter sempre um programa com aquele nome no disquette. Se o 
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programa de saudac¢ao for eliminado (mostraremos como, adiante), aparecera a mensagem de erro 
FILE NOT FOUND toda vez que se carregar o DOS daquele disquette. A Gnica forma de parar 
com a mensagem é colocar um programa no disquette com o nome do programa de saudacao. Isso 
pode ser uma tarefa dificil se esse nome nao for lembrado, porque é dificil determinar o nome do 
programa de saudacao depois de dado o INIT. A melhor solucao é prevenir. Sempre especifique o 
mesmo nome de arquivo quando inicializar disquettes. O nome standard para o programa de sau- 
dacdo é HELLO. 


Usando o Comando INIT 


Um comando INIT tipico parece-se com: 
ANIT HELLO, S6+D12036 


Os numeros de slot, drive e volume sao opcionais. Se o numero de volume for inclufdo, o 
DOS atribui aquele numero de volume ao disquette. O INIT é o Unico comando de atribuicao do 
numero de volume. Quando esse numero é usado com outros comandos do DOS, o numero especi- 
ficado deve coincidir com o atribufdo no momento do INIT. Se tal nimero for omitido, o INIT 
sempre atribuira o nUmero de volume 254. 

Como sempre, a omissdo de numero de drive e slot fara com que sejam usados no comando 
DOS anterior. Tenha certeza de qual drive o comando INIT selecionara. Se nao estiver certo, 
especifique! 

Para inicializar um disquette novo, primeiro remova o ‘‘System Master Diskette’ do drive e 
troque-o por um novo em branco. Use 0 comando NEW para gerar espaco na memoria para o 
programa de saudacao. Digite entado este programa de saudacao mostrado acima, ou qualquer outro 
que desejar. E uma boa idéia rodar o programa de saudacao antes de grava-lo no disquette. 

Vamos atribuir o numero de volume para 123. Digite: 


[MIT HELLO, S4,D4,Y4123 


Certifique-se que a porta do drive esteja fechada e acione RETURN. A lampada do drive se acende- 
ra, acompanhada dos estalos e rujfdos usuais. O processo inteiro leva cerca de dois minutos, 
portanto seja paciente. Apos a lampada apagar, use o comando CATALOG para ver o que esta 
gravado no disquette novo. O resultado deve parecer com: 


DISK VOLUME 123 
I QOO2 HELLO 


ou, usando o Applesoft, deve aparecer: 


DESK VOLUME 123 
A NOB HELLO 


A letra | indica que o programa de apresentacao foi escrito em BASIC. A letra A diz que foi 
escrito em Applesoft. O 002 indica que o programa ocupa dois setores. Pode-se ver um numero 
diferente, dependendo do comprimento do programa de saudacdao particular. 

Prepare um rotulo para o disquette. Escreva o numero de volume do rotulo, assim como 
qualquer informac¢ao que achar necessaria sobre ele. Retire o disquette do drive, aplique o rdtulo e 
coloque-o de volta no drive. Se for necessdrio recarregar usando o disquette recém-preparado, pode 
fazé-lo. 
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SAVE 


Se foram seguidas as orientacdes deste capitulo, teremos agora um disquette recém-inicializado no 
drive 1, slot 6 do Apple ||. Deve-se ter também uma copia do programa de saudacao na memoria. 
Use 0 comando LIST e veja se esta la. Se nao, digite: 


LOAD HELLO 


para ler uma copia do disco. 

O comando SAVE guarda programas em um disquette. Para gravar uma outra copia de seu 
programa de saudacdo, digite o comando SAVE seguido pelo nome do arquivo. Neste exemplo, 
usaremos 0 arquivo chamado PROGRAMA SAUDAGCAO. Pode-se usar qualquer nome de arquivo 
valido desejado. 


SAVE PROGRAMA SAUDACAO 


O disco deve rodar e emitir seus rufdos habituais. Quando o SAVE termina, reaparece o 
cursor e 0 Caractere de apresentacao do BASIC. A seguir use o comando CATALOG para verificar 
o contetido do disco. Aparece entado algo assim: 


DISK VOLUME 123 
A OO2 HELLO 
A OO2 PROGRAMA SAUDACAO 


Pode-se salvar qualquer programa BASIC desejado desta forma. 

Se j4 houver no disquette algum programa gravado com 0 mesmo nome que se der no coman- 
do SAVE, o novo programa gravado pelo SAVE ocupara o lugar do anterior. Assim o programa 
anterior sera automaticamente eliminado. Isso funcionara desde que tanto o velho quanto o 
novo programa sejam da mesma versdo do BASIC. Se nao forem, o novo programa no seré grava- 
do, aparecendo a mensagem FILE TYPE MISMATCH. 


DELETE 


Em pouco tempo acumulam-se muitos programas num disquette que nado tém mais proposito 
algum. O comando DELETE remove arquivos do disquette. 

Para eliminar (‘‘deletar’’) a cOpia do programa de saudac¢do gravado, podem ser usados qual- 
quer dos comandos seguintes (a menos que tenha sido referenciado um outro drive no meio 
tempo). 


DELETE PROGRAMA SAUDACAO,S6,D1,-V12 
DELETE PROGRAMA SAUDACAQ,¥123 
DELETE PROGRAMA SAUDACAS 


Lembre-se que se pode usar os pardmetros slot, drive e volume se quisermos, ou nenhum 
deles se o drive a ser acessado é o Corrente. 
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LOCK 


Alguns programas ou arquivos de dados em disquette devem ser mantidos permanentemente. Para 
isso, o DOS tem uma técnica de protecdo chamada /ocking (travamento). Travar um arquivo evita 
que ele seja acidentalmente eliminado ou que algo seja escrito sobre ele. Para travar um arquivo, 
digite 0 comando LOCK, seguido pelo nome do arquivo e os paradmetros opcionais drive, slot e 
volume. O comando seguinte trava o programa saudacao: 


LOCK HELLO 


E sempre bom travar o programa de saudacao. 

Qualquer tentativa subsequente de eliminar ou gravar sobre um arquivo travado resultara 
na mensagem FILE LOCKED. 

Se o arquivo travado for um programa em Integer BASIC ou Applesoft e for tentado salvar 
um programa com o mesmo nome porém escrito em outro BASIC, a mensagem mostrada sera 
FILE TYPE MISMATCH. , 

Num catéloao de disquette, os arquivos travados sao identificados por um asterisco ( * ) 
precedendo o tipo do arquivo. 


UNLOCK 


Quando se decide regravar ou eliminar um arquivo travado, remove-se o lock com o comando 
UNLOCK. A declara¢ao seguinte destrava o programa saudacao: 


UNLOCK HELLO 


Como sempre, as especificacdes de drive, slot e volume sao opcionais e podem ocorrer em 
qualquer ordem. 


RENAME 


Pode-se trocar 0 nome de qualquer arquivo do disquette. Uma forma de trocar 0 nome de um 
programa seria |é-lo, elimind-lo, e grava-lo com um nome novo. Uma forma melhor é usar 0 coman- 
do RENAME. Ele funciona para qualquer arquivo do disco, independente do tipo de BASIC que 
esta sendo usado. O RENAME também funciona com arquivos de texto e bindrios. Aqui esta um 
exemplo do RENAME: 


RENAME YELHONOME ,NOVONOME 


O DOS nao verifica se o nome do novo arquivo ja existe no disquette. Se existir, ficarao 
dois arquivos com o mesmo nome. Isso pode causar muita confusdo e dificultara a recuperacao. 

Nao faga RENAME com o programa sauda¢ao a menos que coloque um novo programa com 
o nome velho no disquette. O RENAME nado muda nomes que o DOS travou quando o sistema do 
disquette é carregado. 

Nao se pode mudar o nome de um arquivo travado. 

Pode-se especificar o drive, slot e volume (em qualquer ordem) se desejado. 
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VERIFY 


Ocasionalmente, pode-se querer verificar se um arquivo esta intacto. A melhor forma de fazer 
isso 6 usando o comando VERIFY. O comando seguinte testa o programa saudacao: 


VERIFY HELLO,Y123 


A medida que o DOS grava os setores de um arquivo, ele calcula um numero, chamado 
checksum. O seu valor é baseado num valor numérico para cada caractere do setor. Ele também 
é gravado no setor. Quando se executa o comando VERIFY, o DOS recalcula o checksum para 
cada setor do arquivo e compara com o gravado. Se ele detectar qualquer diferenca entre os valo- 
res, sera devolvida a mensagem 1/0 ERROR. 

Se todos os valores calculados coincidirem com os gravados, o DOS naéo manda nenhuma 
mensagem; reaparecem o cursor e o Caractere do BASIC. 

Assim como muitos outros comandos do DOS, pode-se especificar slot, drive e volume na 
ordem que se desejar. 


USANDO COMANDOS DOS 
DOS EM PROGRAMAS 


Até agora todos os comandos do DOS usados foram digitados no teclado do Apple II. Porém os 
programas, em BASIC que usam arquivos podem incluir comandos do DOS. 

Para usar um comando DOS dentro de um programa BASIC, coloca-se uma declaracdo 
PRINT pré-fixada com um cédigo ASCII de 4 caracteres. Use o CTRL-D para criar este prefixo. 
O CTRL-D deve ser o primeiro caractere a sair na declaracdo PRINT. Certifique-se que o PRINT 
dado anteriormente nao foi terminado com uma virgula ou ponto-e-virgula. 

Desde que o CTRL-D produz um caractere que nao é impresso, é recomendavel que se docu- 
mente cada ocorréncia com uma declaracao REM, como aqui: 


TOO PRINT “RUN MENU"? REM EXISTE UM CTRL=6 
ENTRE A PRIMETRA ASPA E O FR DE RUN 


Pode-se simplificar as coisas definindo uma variavel como CTRL-D, e mandando imprimir a 
variavel seguida pelo comando DOS. A varidvel D$ 6 comumente usada para isso, mas pode-se usar 
qualquer outro nome também. Usando a varidvel padronizada D$ em todos os programas eles 
se tornam compativeis uns com os outros e com todos os de outras pessoas. Ponha uma linha 
como a seguinte no seu programa BASIC: 


10 DS = °'S REM EAISTE UM CTYRL=-D ONVISIVEL 
ENTRE AS ASPAS 


ou, em Applesoft, pode-se usar: 
TO DO = THRE €4)° REM CHR (4) = CRYTRL-D 


Assim, sempre que o D$ for usado, sera facil ver que se trata do caractere CTRL-D. 
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Tente rodar o programa mostrado abaixo no seu Apple II: 


10 DS = “*s REM CTRL-D 
=O FOR IT = 4 TO 1490 

20 PRINT O85 “CATALGG” 
4 NEXT T° 

“} EMD 


A menos que se tenha mais de 18 arquivos no disquette, deve-se ver com isso o catalogo mostrado 
10 vezes, sem tocar qualquer tecla. Se existirem mais de 18 entradas no catdlogo, deve-se acionar 
uma tecla cada vez que houver uma parada. 


USANDO ARQUIVOS EM DISCO 


O Apple II opera com dois tipos de arquivos em disco: arquivos sequenciais e aleatérios. Ambos 
contém blocos de dados, chamados campos. Um campo pode ter um ou varios caracteres de com- 
primento. 


Arquivos Seqiienciais 


Arquivos sequenciais, como o nome indica, s6 podem ser acessados de maneira sequencial. Para ler 
ou gravar o Ultimo campo, deve-se primeiro ler ou gravar todos os campos que o antecedem. Para 
algumas aplicac6es, os arquivos sequenciais sao interessantes. 


Arquivos Aleatérios 


Arquivos aleatorios sdo mais flexiveis que os sequenciais. Pode-se ler ou gravar qualquer campo no 
arquivo nao importando sua colocacdo. Para muitas aplicacdes, este tipo de arquivo é a melhor 
solucao. 


USANDO ARQUIVOS SEQUENCIAIS 


Para usar arquivos sequenciais, 6 necessario aprender alguns comandos adicionais do DOS: OPEN, 
CLOSE, READ e WRITE. 


Abrindo Arquivos Sequienciais 


Os arquivos em disco devem ser abertos antes de serem acessados. Abrir um disco faz com que o 
DOS obtenha informac6es sobre ele: se ele esta no disco e, se estiver, sua posicdo. O OPEN tam- 
bém reserva uma drea de memoria para ser usada como buffer para o disco. Este buffer permite 
acessar partes pequenas do arquivo sem necessidade de ativar o drive de disco a cada vez que se 
acessa um Campo, ganhando tempo. O comando OPEN parece-se com: 
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OPEN NOMEARG@,S6,D2,U99 


Se o arquivo nao existe como especificado, o DOS cria um novo no diretério do disco. 

Dentro de um programa, 0 comando OPEN deve estar dentro de uma declaracdo PRINT 
e deve ser precedido pelo caractere CTRL-D. 

O programa abaixo cria o arquivo sequencial SEQUENCIA no disco do drive corrente: 


100 D$ = ““: REM CTRL--D 
200 PRINT O¢3 "OPEN SEQUENCIA” 
200 END 


Vamos chama-lo Programa 7. 


Pode-se incluir qualquer combinacado de pardmetros slot, drive e volume com o comando 
OPEN: 


100 De = © REM CTRL-D 
200 PRINT O¢; "OPEN SEQUENCTIA,S6,01,0123" 
300 END 


ou 
2eO0 PRINT D¢s “OPEN SEQGUENCTA,Y123,S6" 


Note que todos os pardmetros sao colocados antes do fechamento das aspas, e sdo separados por 
virgulas. 

Apos rodar 0 programa, o arquivo SEQUENCIA estaré presente no catalogo. Confirme digi- 
tando CATALOG. Este devera parecer-se com: 


DISK VOLUME 123 


¥f O02 HELLO 
T OO1 SEQUENCTA 


_Veja a letra T antes do ndmero de setores de SEQUENCIA. T é 0 codigo que indica que 
SEQUENCIA é um arquivo de texto, em oposic¢do a arquivos de programa em Applesoft ou Integer 
BASIC, ou arquivos bindrios. O asterisco ( * ) antes do tipo de HELLO indica que ele esta travado. 


Fechando Arquivos 


Na verdade, o Programa 1 é bastante pobre, por uma boa razdo: ele nao fecha o arquivo depois de 
opera-lo. O comando CLOSE é muito importante. Nao fechar os arquivos pode resultar em perda 
de dados, e possivelmente destruig¢ao de dados em outro disquette (veja a secdo sobre panes de 
software neste capitulo). O comando CLOSE tem dois formatos. O primeiro é: 


CLOSE 


O comando CLOSE sem pardmetros fecha todos os arquivos, em todos os disquettes, indepen- 
dente do drive, slot e volume em que estiverem. 

As vezes é necessdrio fechar um ou mais arquivos especificos. Para fechar arquivos indivi- 
duais coloca-se o nome do arquivo na frente do comando CLOSE, como: 
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CLOSE NOMEARG 


Ndo é necessério nem permitido que se coloque parametros de drive, slot ou volume no comando 
CLOSE. O DOS sabe onde o arquivo esta desde que ele ja foi aberto. 
O Programa 1 pode ser corrigido adicionando as linhas: 


290 PRINT D¢3”"CLOSE” 
Ou ainda: 


290 PRINT D¢:"CLOSE SEQUENCTA" 


Gravando em Arquivos Seqiienciais 


O Programa 1 é inutil ainda. Os disquettes sdo usados para armazenar e recuperar informagoes. 
Como nao se pode recuperar nada que nao tenha sido gravado no disco, vamos ver como gravar 
informacoées no disco. 

Mandam-se os dados para o Disk |! da mesma forma que para tela ou impressora: via decla- 
rac¢do PRINT. Qualquer coisa que se imprime pode ser mandada para o disco. De fato, pode-se 
visualizar um arquivo seqUencial como uma teia de video, ou melhor ainda, como papel numa 
impressora. 

Quando se grava alguma coisa em um arquivo, o DOS atualiza um apontador interno, que 
aponta a proxima posicdo da superficie do disco para guardar o proximo dado, tal como a impres- 
sora pula para a proxima linha. 

Um arquivo sequencial s6 pode se mover para a frente. O comando OPEN move o apontador 
para o inicio do arquivo. 

Antes de se gravar qualquer coisa no disco, deve-se antes dar o comando WRITE para infor- 
mar ao DOS que as declaracdes PRINT serao para gravar no arquivo, ao invés da tela. Para arquivos 
sequenciais, o comando WRITE é: 


WRITE NOMEARG 


Apos dar este comando, as safdas subsequentes vao para o arquivo especificado. Note que 
sao incluidas as mensagens de erro. Entretanto, apOs a mensagem ser gravada no arquivo, 0 coman- 
do WRITE é cancelado. S6 é visto o cursor e o caractere do BASIC na tela. 

O comando WRITE deve estar dentro de uma declaracdo PRINT, precedida por CTRL-D. Se 
for tentado dar o comando WRITE no modo imediato, aparece a mensagem de erro NOT DIRECT 
COMMAND. Ponha as seguintes linhas no Programa 1: 


21QO PRINT Ds °WRITE SEQUENCTIA” 
eeQ PRINT “ESTE TEXTG YALL PARA O ARQUTVO” 


Este programa faz o seguinte: 


1. Cria um arquivo, se necessario. 
2. Abre o arquivo. 
3. Guarda texto no arquivo. 


4. Fecha o arquivo. 
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Pode-se inserir tantas declaracdes PRINT entre as linhas 210 e 290 quanto desejado. Pode-se 
gravar texto, numeros e varidveis, em qualquer combinacdo, desde que a sintaxe do PRINT esteja 
correta. Por exemplo: 


ee0 FOR IT = 4 TO 100 
230 PRINT I 
24Q NEXT I 


ewQ PRINT “ABCDEFGHTIKLMNOPGRSTUUWX YZ” 


Veja que sO se usa o prefixo CTRL-D com comandos DOS e nunca quando se esta gravando 
dados no arquivo. 

Tome cuidado para nado gravar dados no arquivo com as funcdes FLASH ou INVERSE 
atuantes, desde que esses caracteres nao sao tratados convenientemente pelo DOS. 

Lembre-se que a cada vez que se roda este programa, o que estiver na declaracdo PRINT vai 
cobrir e apagar os dados que ja estiverem no arquivo. Se forem colocados menos caracteres do que 
Os que ja estiverem Ia, o restando anterior permanecerd, seguindo os novos dados. 

Uma forma de contornar este problema é zerar o arquivo antes de gravar qualquer dado nele. 
O comando DELETE (dentro de uma declaracéo PRINT) pode ser incorporado ao programa antes 
do comando OPEN. Toda vez que o programa rodar, o arquivo sera eliminado e depois recriado 
com 0 comando OPEN. 

_Entretanto, um problema ocorrera ao se tentar rodar o programa sem a presenca do arquivo 
SEQUENCIA no disquette. Se for tentado, apareceré a mensagem FILE NOT FOUND. Pode-se 
prevenir isso dando outro comando OPEN antes do DELETE. Acontecerda o seguinte: 


1. O primeiro comando OPEN cria um arquivo que ainda nao existe. 
2. Ocomando DELETE limpa o arquivo, nado importa quando foi criado. 


3. O segundo comando OPEN cria um novo arquivo vazio. 


Quando fizer estas modificacdes no Programa 1, lembre-se que uma vez especificado o slot, 
drive e volume, nao sera necessdario especifica-los novamente, a menos que se deseje referenciar 
drive diferente. Com isso em mente, use o comando OPEN com os pardmetros slot, drive e volume 
como o primeiro comando DOS, e referencie os comandos seguintes ao drive corrente. 

Apos as modificacdes no Programa 1, ele ficara assim: 


100 OS = "*: REM CTRL-DB 

440 PRINT O97 “OPEN SEQUENCIA,V4183,946,04" 
T2Q0 PRINT OS: °DELETE SEQUENCTA” 

200 PRINT D&s "OPEN SEQUENCTA® 

210 PRINT D4; "WRITE SEQUENCTIA” 

eel) PRINT “ESTE TEXTO VAT PARA © ARGQUTUO” 
=7Q PRINT DS? “CLOSE” 

300 END 


Sempre que se executar este programa, ele vai guardar o contetido das declaracdes PRINT 
entre as linhas 210 e 290 no arquivo SEQUENCIA. Pode-se usar qualquer nome de arquivo que se 
desejar, mas se 0 nome do arquivo for mudado, certifique-se de mudar todas as referéncias ao 
arquivo. 
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Pode-se usar uma varidvel para nome do arquivo e fazer o programa pedir o nome para fazer 
o acesso. Com essa modifica¢ao, o programa fica: 


100 INPUT “NOME DO ARGUIVOcsE¢ 

100 O¢ > REM CTRL-D 

410 PRINT DG: OPEN’ 3F$3°Y423,S6,D1" 

120 PRINT DGs“DELETE’3F$ 

200 PRINT (4: °OPEN SEs 

210 PRINT tts "MRETE* TES 

220 PRINT “ESTE TEXTO “Val Paka OG AR@UTYO" 
290 PRINT D€3°CLOSE” 


20 END 


Pode-se ir mais além e criar um programa que peca os numeros de slot, drive e volume com 
estas modificac6es: 


1O INPUT “NOME DO ARQUIVO: “EF 

20 INPUT “MUMERO DO SLOT: “35 

S0 INPUT “NUMERO DO DRIVE: “sD 

40 TNPUT “NUMERO DO VOLUME: “74 

100 DO = “"2 REM CTRL-D 

410 PRINT Do. OPEN “sFo:1*,6729:",D“ rie" Ver ue ey 


Fazendo estas modificacGes, certifique-se de entrar da forma mostrada, nao se esquecendo de 
incluir virgulas entre os pardmetros S, D e V ou o DOS n@o sera capaz de distinguir os pardmetros 
do nome do arquivo. 

Para tornar o programa realmente Util, pode-se deixar entrar o texto a ser gravado no arqui- 
vo, ao invés de alterar o comando PRINT. Uma forma de fazer isso é: 


TO TNRUT “ENTRE TEXTO PARA GRAVARS “3 14 


2 


n 


mal) PRINT T¢ 


Veja que isso permite apenas a entrada e armazenamento de uma linha de texto. Pode-se alterar 
isso colocando mais declaracdes INPUT seguidas por declaracdes PRINT, mas uma vez mais fica 
determinada a quantidade de texto a ser entrada e guardada. Por que nado colocar um teste apds a 
declaracao INPUT de forma a sinalizar o fim do texto? Ponha entéo um GOTO apés o PRINT 
para entrar outra linha: 


POO TMPUT “EMTRE TEXTO FARA GRAVARS “3 7¢ 
'60 iF TS = “FIM” THEN 290 

S210 PRINT OF8f°WRITE “:FS$ 

eel) PRINT TS 


230 GOTO 150 


Agora, ao terminar de colocar o texto, pode digitar FIM e o arquivo sera fechado. Porém 
resta um grande problema. Lembre-se que 0 comando WRITE causa todas as safdas serem dire- 
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cionadas para o arquivo. Desde que é entrado a declaracado INPUT sai o texto ENTRE TEXTO 
PARA GRAVAR;, essa linha nao aparecerd na tela apOs a execucdo do comando WRITE; ela 
sera armazenada como parte do texto no arquivo em disquette. 

O comando WRITE deve ser cancelado antes que a informacao saia para o disquette. Qual- 
quer comando DOS cancelara o comando WRITE, mas o mais seguro é usar 0 comando nulo, 
que é CTRL-D sozinho. Ponha esta linha de programa: 


eew PRINT 0¢ 


Com todas estas modificacdes, teremos um programa que permite gravar qualquer quanti- 
dade de texto desejada (com o tamanho.maximo do disquette), sob qualquer nome de arquivo, 
em qualquer drive conectado ao Apple II. 


Lendo Arquivos Seqienciais 


Assim como as safdas podem ser direcionadas para o disco, as entradas podem ser aceitas a partir 
de arquivos em disco. O comando READ identifica um arquivo em disco como fonte de dados de 
entrada. Para arquivos sequenciais o comando READ é assim: 


READ NOME AR & 


O comando READ deve estar dentro de uma declaracao PRINT, precedido do caractere 
CTRL-D. Se o comando READ for dado em modo imediato sera mostrado 0 erro NOT DIRECT 
COMMAND. 

Depois do comando READ ser executado, as proximas declaracdes de entrada INPUT 
receberdo dados do arquivo especificado até que outro comando DOS, ou um erro, cancele o 
comando READ. O Programa 2, abaixo, demonstra 0 uso do comando READ: 


TO) DS = TS REM CTRILA-D 

110 INPUT “NOME DO ARQUTYO PARA LES “sks 
120 INPUT “NUMERO DO SLOT 2°35 

1320 UNFUT “NUMERO DO DRIVE '°°D 

140 INPUT “RUMERO DO VOLUME. 2° :4U 
120 PRINT DS7 °OFPEN “fF Se "eS" tS Fe + D's Oe es. e¥ 
140 PRINT DP "READ “tks 

Y7O INPUT ag 

Tho PRINT Ag 

120 GOTO “E70 

OO END 


O Programa 2 mostra todo o texto do arquivo criado pelo Programa 1. Apds todo o texto 
ter sido mostrado, aparecera a mensagem END OF DATA e€ o programa parara com a mensagem 
BREAK IN 170. 

Veja que o Programa 2 nao tem o comando CLOSE. Explicamos que os arquivos devem ser 
fechados quando forem usados mais tarde, porém neste caso ele nao sera gravado, de forma que a 
informacao de trilha/setor nunca precisa ser atualizada (assumindo que o nome do arquivo especi- 
ficado realmente existe). O arquivo poderia ser fechado por questao de seguranca. 
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Nao é uma boa pratica escrever programas que coloquem mensagens de erro e parem sob 
circunstancias previsiveis, como o fim de dados no arquivo. 


Contornando o Erro END OF DATA 


A condicéo END OF DATA pode ser detectada antes de gerar o erro. O Programa 2 pode sair 
para o fechamento de arquivo ao detectar o fim dos dados. A maneira mais facil de detectar o fim 
dos dados é usar 0 comando do Applesoft ONNER GOTO (visto no Capitulo 4), porém o 
ONNER GOTO nfo é permitido no Integer BASIC. (Os cédigos de erro do BASIC sao mostrados 
no Apéndice C.) 

Uma outra forma de achar o fim do texto num arquivo escrito pelo Programa 1 é modifica-lo 
de forma que quando for digitada a palavra FIM, uma palavra ou caractere especial seja escrita 
antes de fechar o arquivo. Assim o Programa 2 procurara pelo caractere especial para fechar o 
arquivo de acordo. Este método funciona tanto no Applesoft quanto no Integer BASIC. 


Diferencas entre o Applesoft e o Integer BASIC 


O comando READ identifica um arquivo em disco como fonte de dados para as declaracoes 
INPUT subseqiientes. Porém essas declaracdes devem ter sua sintaxe de acordo com o BASIC 
utilizado para o programa (veja o Capitulo 8). De qualquer forma, os dados fornecidos por um 
arquivo dependem da forma como eles foram guardados. 

Veja 0 programa: 


120 Gb = “"s REM CTRL=D 

200 PRINT D$;°OPEN ARQ” 

S00 PRINT Dés°WRITE AR@t” 

400 PRINT “ALO’.” RODANDO PROGRAMA DE TESTE” 
HOO PRINT [83° CLOSE” 

é00 END 


Em Applesoft, rode este programa, e leia o texto de ARQ1 mudando as linhas 300 e 400: 


200 PRINT D3 "READ AR GT” 
&QQ IMPUT Ae 


O valor de A$ 6 ALO RODANDO PROGRAMA DE TESTE. Mude 0 original para gravar 
de novo: 


300 PRIN( DSs"WRITE ARQt“ 
400 PRINT “ALO, RODANDO PROGRAMA DE TESTE” 


e execute-o. Agora leia o valor guardado como antes. Agora apareceu a mensagem ?EXTRA 
IGNORED, e A$ é ALO. 

Em Applesoft, as virgulas separam valores multiplos numa declaracdo PRINT Gnica. 

O Integer BASIC aceita ambas as linhas como uma, de forma que o valor de A$ guardado 
pelo primeiro exemplo seré ALO RODANDO PROGRAMA DE TESTE, € 0 valor de A$ na segun- 
da versao da linha 400 seré ALO, RODANDO PROGRAMA DE TESTE. 
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Usando a Declaragdo GET do Applesoft para Ler Arquivos de Texto 


Em Applesoft, a declaragdo GET pode ser usada para ler dados de arquivos em disco. A declaracao 
GET difere da INPUT por aceitar um caractere de cada vez. Assim, se um arquivo contém o texto 
ESTE ARQUIVO CONTEM TEXTO, e é executado um OPEN, um READ, e depois um GET, o 
primeiro GET devolverd a letra E; 0 proximo GET devolvera a letra S, e os GET subseqiientes 
devolverao T, E, espaco em branco, A, R, Q, U, |, V, O etc., até que todos os caracteres do texto 
tenham sido lidos. Se o GET devolver virgulas ou Carriage Return, o programa podera detectar e 
interpretar de acordo. 

O Programa 3, mostrado abaixo, demonstra como um arquivo pode ser lido, usando a decla- 
rag¢ao GET do Applesoft para montar uma linha de texto, um caractere por vez. 


100 Dt = CHR (4): REM CTRL-DB 

“OO INPUT “NOME DO ARQUIVO PARA LER: “sF¢ 
200 INPUT “NUMERO DO SLOTS “#5 

400 INPUT “NUMERO DO DRIVE: “sb 

“O00 [NPUT “NUMERO DO VOLUME: “3V 

GOO PRINT O8F°OPEN “FFEI". 07308" .0° DF". S735 
700 PRINT D&?°READ “3F4 

BOQ BR = ”* 

POO GET Aas 

{OOO TF At = CHEE (13) THEN 1300 

1100 BS = BS + Ag 

T200 GOTO 700 

1300 REM DEVOLYE CARACTERE ACHADO 

1400 REM B¢ ESTA COMPLETO 

{500 PRINT B¢ 

1600 GOTO 800 

1700 END 


Porém a declaracgado GET tem um problema quando usada com arquivos em disco. O pri- 
meiro caractere impresso apds o GET ter sido executado é ignorado. Se o primeiro caractere é 
um comando DOS, entao o caractere CTRL-D sera ignorado, o que significa que todo comando 
DOS sera impresso e nao interpretado como comando DOS. 

Para resolver este problema é preciso imprimir um caractere sem significado primeiro, que 
sera ignorado. Um bom caractere para usar 6 o CTRL-A (cédigo 1 ASCII), por ele nado ser impri- 
mivel e nado ter significado especial (em oposicao ao CTRL-D, por exemplo). 

O Programa 3 pode ser corrigido, trocando a linha 1500 para ler: 


13500 PRINT CHRS (C4)73B¢: REM CHRS (C1) = CTRL-A 


Guardando Nameros em Arquivos 


Pode-se usar o Programa 1 para guardar numeros em arquivos, tanto como parte de texto, como 
em: 


eeQ PRINT “MEU ENDERECO E RUA DEZ NUMERO 1123” 
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quanto diretamente em valores numéricos: 
230 PRINT 1,2,/3,74:5 
ou via varidveis numéricas: 
240 PRINT A,B,C,B-E 


Se forem guardados nuimeros diretamente, pode aparecer um resultado estranho ao se ler de volta 
no Programa 2. 

Usando o Integer BASIC, niimeros separados por virgulas ou pontos-e-virgulas formaraéo um 
numero grande (12345 na linha 230 acima); para um total de uma linha de safda. 

Usando Applesoft, isso se torna ainda mais confuso; os primeiros trés numeros sao concate- 
nados (123) e vistos como uma safda de impressdo. Os proximos dois valores (4 e 5) produzem 
uma linha de safda cada, dando o total de trés linhas de sa/da. 

Esses problemas vém do formato usado para guardar dados em arquivos de disco. As virgulas 
nado sao armazenadas entre os nimeros se eles nao forem para a tela. Em vez disso, na tela a vir- 
gula causa a impressdo do dado na proxima linha de tabulacdo. Quando a saida é direcionada para 
O arquivo, entretanto, o DOS despreza completamente as virgulas. Nao acontece nada equivalente 
a tabulacdo. Como resultado, os valores tornam-se concatenados até que o retorno (cddigo 13) os 
separe. Ele, Carriage Return, é o Unico caractere que o DOS interpreta como separador de valores. 
O Integer BASIC manda um Carriage Return apés a quinta parada de tabula¢ao (virgula), enquanto 
o Applesoft o manda apos a terceira. 

Para evitar problemas, certifique-se de que cada campo numérico guardado num arquivo em 
disco seja seguido pelo caractere Carriage Return. A forma mais facil de fazer isso é mandar cada 
numero com uma declaracaéo PRINT separada: 


23() PRINT 12 PRINT @: PRINT 3: PRINY 4: 
PRINT & 


Outro método permitido aos usuarios do Applesoft é incluir um caractere Carriage Return como 
separador na lista de parametros da declaragaéo PRINT: 


230 PRINT TICHR#(13) 72ICHRE C1325 35 CHRS 61 
S345 CHR C1375 


Pode ser mais cOmodo definir uma varidvel como o caractere Carriage Return, e imprimi-la: 


11 RS = CHREC13)2 REM CARACTERE RETURN 


230 PRINT TsR¢s 23 Res SIRs 4sREe5 
Isso torna o programa mais limpo. 
COMO INSERIR DADOS NUM ARQUIVO SEQUENCIAL 


Um arquivo seqlencial deve ser fechado apos se gravar dados nele. Quando se fecha um arquivo, 
perde-se o controle do local em que o Ultimo item foi gravado. Para adicionar dados ao fim do 
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arquivo, entao, deve-se primeiro achd-/o. Pode-se ler cada item do arquivo até o Ultimo, porém 
isso Consome muito tempo para arquivos longos. O comando APPEND faz isso para nos. 

Este comando APPEND coloca o apontador de arquivo no primeiro caractere nao usado 
apos o fim do arquivo. Se for dado um READ apés o APPEND, obtém-se a mensagem de erro 
END OF DATA. Se se grava apds o APPEND, o novo dado sera adicionado ao que ja estava no 
arquivo. 

O comando APPEND é usado no lugar do OPEN. Existem duas diferencas importantes entre 
os comandos APPEND e OPEN: 


1. O APPEND requer que o arquivo ja exista. Se nado, o erro FILE NOT FOUND aparece. 
O APPEND né@o cria arquivo, ele assume que 0 arquivo ja existe. 


2. O APPEND coloca o apontador no fina/ do arquivo. O OPEN coloca o apontador no 
inicio do arquivo. 


O formato para o comando APPEND é o mesmo que o do comando OPEN. Aqui esta um 
exemplo: 


APPEND NOMEARQ,S&,D2,U99 


Como sempre, os comandos slot, drive e volume sdo opcionais. 


O COMANDO POSITION 


Outro comando util é o POSITION. Ele move o apontador para a frente (nunca para tras) do nu- 
mero especificado de campos em relacdo a posicao atual do apontador. O comando se parece 
com: 


POSTTION HOMEARG, R3O 


R indica campo relativo, o nimero apds o R da o numero de campos para pular. Os campos 
sao marcados pelo caractere carriage return, e 0 comando POSITION acima conta 30 carriages 
returns a partir da posi¢ao atual e move o apontador do arquivo para la. Se for dado um RO, o 
apontador nao se move. 

Na verdade, o POSITION examina o arquivo caractere por caractere, iniciando pela posicao 
corrente. Se ndo existirem campos suficientes, ou é encontrado um byte nao usado, o erro END 
OF DATA é mostrado imediatamente. Nao é necessdrio executar o INPUT ou o GET para dar a 
mensagem de erro. 

Um arquivo deve ser aberto antes que possa ser referenciado pelo POSITION. Quando se 
abre o arquivo, seu apontador fica apontado para o inicio, se for dado 0 comando POSITION 
quando o apontador estiver no inicio do arquivo, ele ira efetivamente acessar o campo abso/luto 
dentro do arquivo. 

Lembre-se, como qualquer outro comando do DOS, o POSITION cancela os comandos 
READ e WRITE. Utilize o POSITION antes do READ e do WRITE e nao depois. 
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USANDO ARQUIVOS DE ACESSO ALEATORIO 


Os arquivos de acesso aleatério sao estruturados em secdes chamadas registros. Cada registro 
num arquivo particular suporta a mesma quantidade de informacdo, definida em numero de bytes 
(caracteres), quando o arquivo 6 criado. 

A quantidade de informacdo que pode ser guardada num registro é referida como compri- 
mento do registro. 

Os registros sao identificados por um numero indicando sua posi¢cao absoluta no arquivo. 
O primeiro registro de todo arquivo tem nimero 0, o seguinte numero 1, seguido pelo ° etc. 

O menor arquivo de acesso aleatorio tem um registro. A expansao é feita quando novos regis- 
tros sdo adicionados, porém eles ndo encolhem. Para remover registros nao usados de um arquivo 
de acesso aleatorio e reduzir seu tamanho, deve-se copiar os registros que devem ser preservados em 
outro arquivo aleatorio novo. 

Os programas devem especificar qual registro de um arquivo aleatério deve ser selecionado 
e que parte dentro desse registro deve ser acessada. 


Abrindo Arquivos de Acesso Aleatério 


Para definir um arquivo como de acesso aleatério, deve-se incluir um parametro adicional quando o 
arquivo é aberto. O parametro (L) especifica o comprimento de cada registro, como aqui: 


OPEN MOMEARG@,L10.56,D7,V700 


O paradmetro comprimento deve ter um valor entre 1 e 32767. Nao deve ser o primeiro parametro 
na lista, mas deve estar presente se o arquivo for de acesso aleatorio. 

Os programas nunca devem gravar registros maiores que o tamanho especificado no para- 
metro L, incluindo virgulas e carriages returns. Se forem gravados caracteres em excesso num 
registro, O registro seguinte podera ser superposto ou combinado, destruindo sua informacdo. 


Fechando um Arquivo de Acesso Aleatdério 


O comando CLOSE é idéntico para os arquivos de acesso sequencial e aleatorio. 


Leitura e Gravagdo em Acesso Aleatério 


Os comandos READ e WRITE requerem o pardmetro registro para arquivos de acesso aleatorio. 
O pardmetro registro move o apontador do arquivo para o inicio do registro. O exemplo seguinte 
usa O parametro registro (R): 


READ NOMEAR@, E13 
ou 
WRITE NOMEAR@,R64 


O paradmetro registro ndo precisa ser o Unico numa lista, pode-se também especificar drive, 
slot e volume. Os parametros podem aparecer em qualquer ordem. Se o parametro registro nao esta 
presente 0 apontador ndo se move. 
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UM EXEMPLO PRATICO DE ACESSO ALEATORIO 


Os programas seguintes demonstram um uso pratico de arquivos de acesso aleatério. Eles rodam 
tanto em Applesoft quanto em Integer BASIC. Para usar o segundo programa em Integer BASIC, 
adicione uma declaracdéo DIM antes da linha 100, para a varidvel B$ e C$ (255 caracteres cada). 
O primeiro programa cria um arquivo de nome RANDOM. 


10 REM PROGRAMA DE CRIACAO DE ARQUIVO ALEATORIO 

20 REM 

30 REM RODE ESTE PROGRAMA PRIMEIRO, POTS ELE 

40 REM GUARDA INFORMACAO NO REGISTRO ZERO, QUE 

YO REM DEVE EXISTIR PARA © PROXIMO PROGRAMA OFERAR. 

60 REM 

100 DS = “*"3 REM CTRL-D 

200 PRINT D#;7”OPEN RANDOM,S46,D1,L256”" = REM ABRE ARQUIVO 
300 PRINT D&?"WRITE RANDOM,RO” = REM GRAVA REGISTRO ZERO 
400 PRINT 0 = REM GUARDA ZERO NO REGISTRO ZERO 

YOO PRINT D$?;”°CLOSE” = REM FECHA ARQUIVO 

600 END 


Uma vez que o arquivo tenha sido criado, o segundo programa permite ler, alterar, adicionar 
e listar os registros do arquivo. Cada registro contera uma lista de informac¢oes digitadas no teclado. 


10 REM DEMONSTRACAO DE ARQUIVO DE ACESSO ALEATORIO 
20 REM 

30 REM ESTE PROGRAMA MONTA UM ARQUIVO ALEATORIO 

40 REM QUE CONSISTE EM REGISTROS DE UMA UNICA LINHA 
YO REM 

40 REM O REGISTRO ZERO CONTEM UM NUMERO INDICANDO 
70 REM O ULTIMO NUMERO DE REGISTRO EM USO. 


60 REM 

8S REM NOTA! O ARQUIVO “RANDOM” DEVE SER CRIADO ANTES 
90 REM DE TENTAR USAR ESTE PROGRAMA 

93 REM 


100 0$ = “” BEM CTRL-D 

200 PRINT D&?°OPEN RANDOM,S6,D1,L256% 

22m PRINT D&s”"READ RANDOM,RO” = REM LE REGISTRO ZERO 
290 INPUT M = REM M = O ULTIMO REGISTRO EM USO 
275 PRINT DOD = REM CANCELA O COMANDO READ 

300 CALL -9346 = REM LIMPA A TELA 

400 PRINT “DEMONSTRACAO DE ACESSO ALEATORIO” 
YOO PRINT = PRINT = PRINT 

600 PRINT “COMANDOS:” & PRINT 

700 PRINT * QO = PARA” 

S00 PRINT “ 1 = LE UM REGISTRO” 
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SOO PRINT “ 2 = SOMA UM REGISTRO” 

1O00 PRINT “ 3 = MUDA UM REGISTRO” 

1700 PRINT “ 4 = LISTA TODOS REGISTROS“ 
1200 PRINT = PRINT 

1300 PRINT “QUAL”; 

1400 INPUT C 


1500 IF C=0 THEN 8300 © REM PULA 

$600 TF C=1 THEN 2200 =: REM PARA 

1700 IF C=2 THEN 3300 © REM A 

1800 IF C=3 THEN 4600 © REM ROTINA 

1900 IF C=4 THEN 6700 = REM SELECTONADA 
2000 GOTO 300 = REM OU REFAZ O MENU 


2050 REM 

2100 REM * * * ® LE UM REGISTRO * « * * 

2150 REM 

eeQQ CALL -936 = REM LIMPA A TELA 

2300 PRINT = PRINT “LE UM REGISTRO” = PRINT 

e400 PRINT “QUE NUMERO DE REGISTRO (O PARA PARAR)D”: 
200 INPUT R 

2600 IF R<t THEN 300 © REM RETORNA AO MENU PPAL 

2650 IF ROM THEN 2200 = REM REGISTRO NAO EXISTE 

2/QO PRINT D¢; "READ RANDOM,R“?R = REM PREPARA PARA LER 
2800 INPUT BS © REM LE OS DADOS 

ea?00 PRINT D€ © REM CANCELA O COMANDO READ 

2000 PRINT : PRINT B¢ : PRINT =: REM MOSTRA © DADO 

2100 GOTO 2400 © REM PEDE OUTRO NUMERO DE REGISTRO 
3130 REM 

se2QQ REM ® * * * SOMA UM REGISTRO * * *® & 

sev REM 

22300 CALL -934 ©: REM LIMPA TELA 

2400 PRINT = PRINT “ADICIONA UM REGISTRO” = PRINT 

SOOO PRINT “PROXIMO NUMERO DE REGISTRO = “3M+4 

32606 PRINT © PRINT "ENTRA DADO PARA O REGISTRO “7M+1 
225 PRINT “CDIGITE CRETURNI AGORA FARA PARAR AUMENTO) ” 
2700 INPUT B# © REM PEGA RESPOSTA BDO USUARTO 

3750 IF BS = “* THEN 3O0O = REM SATR COM TECLA CRETURNI 
2800 PRINT DG? "WRITE RANDOM,R°FM4+1 &§ REM PREPARA 
P/ESCREVER 

S900 PRINT 6& © REM MANDA DADO PARA ARGUTVO 

4000 M = M + 1°95 REM INCREMENTA ULTIMO NUMERO DE REGISTRO 
4100 PRINT DS;"“WRITE RANDOM-RO” = REM PREPARA PARA 
ESCREVER 

4200 PRINT M = REM GUARDA WALOR ATUAL 

4300 PRINT D& © REM CANCELA COMANDO WRITE 

“400 GOTO 3500 © REM VOLTA PARA OUTRO REGISTRO 
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4450 
4500 
4350 
4600 
4700 
4800 
4900 
IO00 
3030 
3100 
3200 
5300 
3400) 
3300 
3400 
3700 
S800 
S700. 
&é000 
6100 
6200 
&300 
6400 
6300 
6550 
£600 
5450 
4700 
&800 
6900 
7QO00 
7100 
7200 
7300 
7400 
7300 
7400 
7700 
7800 


MENS 


7900 
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REM 

REM * *% * * ALTERA UM REGISTRO * *% * 

REM 

CALL -936 © REM LIMPA A TELA 

PRINT = PRINT “ALTERAR REGISTRO” & PRINT 

PRINT “NUMERO DO REGISTRO (0 PARA PARAR)”; 

INPUT R 

IF &<1 THEN 300 = REM VOLTA AQ MENU PRINCIPAL 

IF R>M THEN 4600 = REM TENTA DE NOVO SE NAO HA REG. 
PRINT D&;"READ RANDOM-R”FR © REM PREPARA PARA LER 
INPUT BS = REM LE 9 REGISTRO 

PRINT D& = REM CANCELA O COMANDO READ 

PRINT = PRINT B& © PRINT = REM MOSTRA O DADO 

PRINT “ENTRA ©O NOVO DADO” 

PRINT “CACTONE CRETURN] PARA PARAR ALTERACAQ)” 
PRINT 

INPUT C% = REM PEGA RESPOSTA DO USUARTO 

IF C$>°” THEN 6200 © REM FULA SE DADO NOVO 

PRINT “REGISTRO “+R?” INTACTO ! '§ § “s REM VOLTA SE 
GOTO 4800 = REM NAO DESEJA ALTERAR 

PRINT D&F"WRITE RANDOM,R“ SR © REM PREPARA PARA GRAVAR 
PRINT C © REM GUARDA DADO AL TERADO 

PRINT D&® © REM CANCELA COMANDO WRITE 

GOTO 4800 ! REM VOLTA PARA ALTERAR OUTRO REGISTRO 
REM 

REM * * * * LISTA TODOS OS REGISTROS * * * x 

REM 

CALL =<936 3 REM LIMPA TELA 

PRINT = PRINT “LISTA TODOS OS REGISTROS” & PRINT 
R= 9 © REM LIMPA O CONTADOR 

R= R + 7 & REM INCREMENTA CONTADOR 

IF R¢M THEN 7700 © REM PARA APOS ULT.REGISTRO 

PRINT D&; "READ RANDOM,R“ FR = REM PREPARA PARA LER 
INPUT BS © REM LE O DADO 

PRINT “NUMERO DO REGISTRO = “FR © REM NUM.DGO REGISTRG 
PRINT B% © PRINT &= REM MOSTRA DADOS DO REGISTRSG 
SOTO 7000 | REM LOOP FARA PROXIMO REGISTRO 

PRINT D& © REM CANCELA COMANDO READ 

PRINT & PRINT “* * # ® FIM-DE-ARGUIYO”" & REM MOSTRA 
AGEM EOF 

PRINT “ACIONE RETURN PARA CONTINUAR’? © REM PEDE A 


RESPOSTA 


8000 
8100 
8150 


INPUT BS = REM PEGA RESPOSTA DO USUARIO 
GOTO 300 = REM RETORNA AO MENU PRINCIPAL 
REM 
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B200 REM * *% * # PARA O PROGRAMA * * * * 

8250 REM 

8300 PRINT D$;"CLOSE” © REM FECHA ARQUIVO 

8400 CALL -934 2 REM LIMPA TELA 

B500 FOR I = 4 TO 24 : PRINT © NEXT TIT = REM MOVE PARA 
ULTIMA LINHA 

8600 PRINT “PROGRAMA COMPLETO.” 

B00 END 


O PARAMETRO BYTE 


Byte é um outro parametro Util para arquivo aleatério. O parametro byte é usado com os coman- 
dos READ, WRITE e POSITION para mover o apontador a um byte especifico (caractere) dentro 
de um registro selectado. Uma virgula e a letra B podem ser adicionadas ao comando READ, 
WRITE e POSITION. O pardmetro registro deve estar presente com o pardmetro byte. Aqui esta 
um exemplo: 


READ NOMEARG,R19,B3 


Neste exemplo, a leitura iniciaré no quarto byte do vigésimo registro. (Lembre-se, o primeiro 
byte tem numero 0.) O pardmetro byte pode mover o apontador para a frente ou para tras dentro 
do registro. 

Se for usado o pardmetro byte, os registros devem ter um formato exato de dados. Deve-se 
saber a posicao exata dos bytes de cada campo dentro do registro, ou o resultado obtido nao tera 
maior significado. 

Quando estiver usando o parametro byte com o comando POSITION, lembre-se que ele 
cancela qualquer comando READ ou WRITE anterior. Pode-se executar um Ccomando READ ou 
WRITE que inclua um paradmetro de registro, e entaéo usar o POSITION para mover para a frente 
até o campo correto. Deve-se entado executar outro READ ou WRITE, desde que o POSITION 
cancele os comandos READ ou WRITE anteriores. 

O POSITION apenas move o apontador a frente para outro campo no registro corrente. 
Dentro do campo, o pardmetro byte permite referenciar subcampos, um Caractere por vez. 


OUTROS COMANDOS DOS 


Existem alguns outros comandos que ainda nao foram estudados. Sado eles o EXEC, MAXFILES, 
TRACE, MON e NOMON. 


EXEC 


O EXEC é um comando muito especial. Ele permite dar 0 controle do Apple,!! para um arquivo 
de texto. O comando EXEC se parece com: 
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EXEC NOMEARQ,R&,S5,D2-V23 


O pardmetro R é similar ao pardmetro de registro do comando POSITION. Ele referencia o 
numero de campo relativo ao arquivo onde o processamento inicia na execucdo do EXEC. Como o 
EXEC abre o arquivo e coloca o apontador no inicio do arquivo EXEC, o paradmetro R referencia 
um numero de campo absoluto dentro do arquivo. RO é a condicado por auséncia de informacao, 
que inicia a execucao no inicio do arquivo. R1 inicia a execu¢ao no segundo campo. 

As especificacdes de registro relativo, slot, drive e volume sao opcionais e podem ocorrer em 
qualquer ordem. 

Quando é executado um EXEC, o arquivo especificado é aberto, e as declaracdes READ e 
INPUT implicitas séo executadas. Se ndo houver nenhum paradmetro R presente, a primeira linha 
no arquivo é tomada. Se houver R, entdo a linha especificada pelo R é tomada. 

A linha tomada é tratada como se ela fosse digitada no teclado em modo imediato. Se a linha 
nao tiver significancia, apareceré a mensagem ?SYNTAX ERROR ou *** SINTAX ERR. Se for 
uma linha valida, como: 


100 PRINT “ISTO E UM TESTE’ 


sera guardada na memoria, como se tivesse sido digitada. Se for um comando direto, como LIST 
ou RUN, sera executada. 

Apos a execucdo do comando da primeira linha, a linha seguinte é lida e executada. Assim 
O processo continua até que o fim do arquivo seja encontrado, quando o controle do Apple II 
retorna ao teclado. 

Suponha um arquivo de texto chamado BUBBA que contenha as seguintes linhas: 


PRINT “EU TENHO CONTROLE SOBRE SEU APPLE ! |! 1° 
re 

TOO GR 

200 FOR T = 9 TO 3¢ 

200 FOR J = OG TO SF 

4QQ) COLOR =RAND CO) #15 

300 PLOT Lad 

oO NEXT 2 

OO NEXT I 

BUO FOR I = 41 TO SODG & NEXT I 
700 TRAT & CALL =936 

79? END 

baked 


FOR T = 41 TO S000 © NEXT I 
RUN 


MEA 
PRINT “TERMINOU.AGUT ESTA O TATALGGO DO BLSCos” 
CATALOG 


Quando for digitado o comando: 
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EXEC BUBBA 


varias Coisas vao acontecer. Primeiro a mensagem ser4 mostrada. Depois o Applesoft sera chamado. 
Depois, um pequeno programa sera carregado na memoria e listado. Apds uma breve pausa o pro- 
grama sera rodado, e entdo tirado da memoria. Outra mensagem aparece, seguida pelo catalogo do 
disco corrente. 


Notas sobre o EXEC 


O EXEC tem varias facetas interessantes que é bom conhecer. 

Apenas um arquivo EXEC pode ser aberto de uma vez. Se um arquivo que esta sendo aces- 
sado pelo EXEC contém um comando EXEC, o primeiro arquivo sera fechado e o segundo pegara 
o controle. Depois de um arquivo EXEC executar um programa, o proximo campo (isto é, linha) 
é executado. Se o programa é abortado com CTRL-C, o EXEC n@o continuara. 

Se um programa que esta rodando sob um comando EXEC contém uma declaracao INPUT, 
a entrada é feita com o campo seguinte do arquivo EXEC. Isso causa um problema, se o proximo 
campo é um comando DOS em modo imediato (e nado uma linha de programa). O comando sera 
executado no lugar de ser interpretado como dado para a declaracao INPUT. 

Se um programa executa um comando CLOSE, ou se o arquivo EXEC contém um comando 
CLOSE em modo imediato, o arquivo EXEC nao sera fechado. 


Usando o EXEC para Converter um Programa de um BASIC para Outro 


O EXEC pode ser usado para converter programas entre o Integer BASIC e 0 Applesoft. Se a con- 
versdo for do Applesoft para o Integer BASIC, deve-se primeiro editar o programa Applesoft para 
adaptar a sintaxe do Integer BASIC. Deve-se entao guardar o programa como arquivo de texto. 
Para isso, ponha algumas linhas no programa para criar 0 arquivo de texto, execute 0 comando 
WRITE e entdo liste o programa. A listagem vai para o arquivo de texto. Aqui estado as declaracdes 
necessdrias: 


at, 


POKE 3,992 REM DESLIGA A FORMATACAG “LIST” 

O€ = “"s PRINT DS°OPEN FILE: PRINT D&s°WRITE FILE” 
LIS? 10,32767 

& PRINT D3 “CLOSE*s END 

5S POKE 33,40: REM REFAZ FORMATO “LIST* 

10 REM SEM PROGRAMA INICIA AQUI 


wm Ras f8.2 


Quando se roda o programa, apenas as linhas 1, 2, 3, 4 e 5 sao executadas. Elas abrem um arquivo 
e€ guardam o programa listado nele. Quando terminar, pode-se trocar para o outro BASIC (com FP 
ou INT, por exemplo). Digite entao: 


EXE FILLE 


As linhas do programa velho sao carregadas do disco para a memoria. Se ainda nao foi feito, deve- 
se editar 0 programa para Corrigir as partes que ainda nao estao de acordo com as regras da nova 
linguagem. 


192 APPLE II 


MAXFILES 


O MAXFILES permite especificar o numero maximo de arquivos que podem estar abertos a qual- 
quer tempo. Cada arquivo tem 595 bytes de memoria reservados para seu uso como buffer. Exis- 
tem apenas duas secdes de 256 bytes em cada buffer, uma para leitura e outra para gravacao. 
Os 83 bytes restantes sdo usados para controle, como lista de trilha/setor. 

Quando um arquivo é aberto, ou ocorre uma operacdo em disco tal como CATALOG ou 
LOCK, o DOS |é 256 bytes de informacdo do disco e a coloca num buffer. Se a informacao é 
alterada e deve ser colocada de volta no disquette, 256 bytes sdo copiadas do buffer e transferidas 
para o disquette. 

O exemplo seguinte especifica oito arquivos no maximo: 


MAXFILES & 
O numero de arquivos deve ser um inteiro entre 1 e 16. Quando o DOS é carregado, sao alocados 
trés buffers. O MAXFILES pode ser empregado se for necessdrio usar mais de trés arquivos simul- 
taneamente. E pode ser também usado para menos se os bytes de buffer precisarem ser usados 


para sua aplicacdo especifica. 
Um buffer 6 usado para executar qualquer um dos comandos DOS seguintes: 


APPEND re POSITION 
BLOAD INIT READ 
BRUN INT RENAME 
BSAVE LOAD RUN 
CATALOG LOCK SAVE 
CHAIN MAXFILES UNLOCK 
CLOSE MON VERIFY 
DELETE NOMON WRITE 
EXEC OPEN 


Dessa forma, se se abrem arquivos acima do limite e se dé um comando CATALOG, o erro 
NO BUFFER AVAILABLE é mostrado. Nao é requerido buffer para comandos usados fora do 
contexto do DOS (por exemplo, comando LOAD de cassette). 

Quando o MAXFILES 6 trocado, os programas no Integer BASIC sdo zerados e os corddes 
no Applesoft sdo destruidos. Por isso deve-se executar o MAXFILES antes de carregar e executar 
qualquer programa. 

Pode-se executar o MAXFILES dentro de um programa no Applesoft se precedido por um 
caractere CTRL-D numa declaracdo PRINT. O MAXFILES faz as instrucdes GOTO, GOSUB e 
outras do tipo, funcionarem incorretamente, a menos que seja a primeira declaracao num progra- 
ma. Para evitar destruicao de corddes, use o MAXFILES como abaixo: 


J1 REM PRIMETRO ATRIBUTCAGS MAXFILES 
J2 PRINT CHR (4) 9 °MAAFILES 9” 

J3 REM PROGRAMA MORMAL COMECA AGQLUT 
14 Dt=CHRECGISREM CARACTERE CTRL 
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S6 se pode usar MAXFILES em Integer BASIC no contexto de um arquivo EXEC. Por 
exemplo, o arquivo EXEC contém trés declaragdes em modo pseudo-imediato: 


MAXFILES & 
LOAD PROGRAM 
RUN 10 


Ele é chamado num programa como segue: 
—& PRINT Ds "EXEC MXF’*:S REM MANDA MAXFILES 
PONTIANUA Na LINHA 10 
{0 REM PROGRAMA COMECA Aall 


USANDO INSTRUMENTOS DE DEPURACAO DO DOS 


Como os programas que acessam arquivos em disco sao em geral de alguma complexidade, o 
DOS tem trés comandos que ajudam a depurar programas: MON, NOMON e TRACE. 


MON 


MON é abreviacdo de monitor. Ele permite monitorar as informacdes que vao e vém do disco. 
O MON usa trés parametros. O exemplo seguinte mostra todos os trés: 


MON 0,7, 


Os pardmetros do MON especificam o tipo de informacdo a ser mostrado. C causa a monitoracao 
dos comandos de disco. | causa a mostra das entradas que vém do disco. O causa a mostra das 
saidas para o disco. 

Os pardmetros podem aparecer em qualquer ordem, e em qualquer combinacao. No mi- 
nimo um pardmetro deve estar presente ou o comando é ignorado. 

O MON permanece operando até que um NOMON, INIT ou FP seja executado, ou o DOS 
recarregado. 


NOMON 


O NOMON cancela o efeito do comando MON. Ele usa os mesmos trés pardmetros que o MON 
usa, porém com o NOMON eles especificam quais dados nado devem ser monitorados. Por exemplo, 
assumindo que foi dado o MON I, O, C anterior, o comando: 

HOMGH O 


cancela a monitoracdo da saida para disco. A entrada do disco e os comandos DOS continuardo 
sendo mostrados. 
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Usando o Comando TRACE 


O comando TRACE (veja Capitulo 4) é usado na depuracado de programas. Mas como ele mostra 
os n&meros das linhas sem carriage return, os comandos DOS ficam concatenados aos nimeros das 
linhas, e ignorados. O remédio para isso é simples. Um carriage return deve ser colocado antes de 
cada comando DOS. Para isso troque a linha: 


{O00 DO = CHR (4) 5 REM CTRL-D 
para ler: 
400 O = CHRS (133 + CHR (43:5 REM RETURN + CTRL-D 


Assim, sempre que o PRINT D$ ocorrer, o caractere CTRL-D sera precedido por um carriage return, 
separando-o da execucao do comando TRACE comum. 

Entretanto, outro problema existe. Se um comando WRITE esta em processo, todos aqueles 
nuimeros de linhas serdo guardados no arquivo. (Desculpem, este problema nao pode ser contor- 
nado.) 


LINGUAGEM DE MAQUINA 
ARQUIVOS DE DISCO (IMAGEM BINARIA) 


O Disk I] suporta arquivo em linguagem de maquina e imagem binaria (graficos). Esses arquivos 
s4o mostrados com a letra B como cédigo de tipo no catalogo do disco. 

Podem ser guardadas imagens tanto de baixa quanto de alta resolucao em disquette para 
posterior recuperacdo e uso. 

Os programas em linguagem de maquina podem ser carregados e rodados diretamente, ou 
podem ser chamados por programas em BASIC usando a declaracao CALL ou a funcao USR. 

O DOS tem trés comandos especialmente projetados para arquivos bindrios. Sao eles o 
BSAVE, BLOAD e BRUN. O efeito de cada um deles 6 0 mesmo que o de seus equivalentes nao 
bindrios (BSAVE=SAVE, BLOAD=LOAD, BRUN=RUN). 


BSAVE 


BSAVE como o nome indica, guarda a imagem bindria no disco. Aqui vai um exemplo: 
BSAVE NOMEARQ,A3768,L21,56-D2,V2 


Note que existem dois parametros nao encontrados em outros comandos DOS. Veja também 
que esses pardmetros nao sdo opcionais; eles devem ser especificados. Os parametros slot, drive e 
volume sao opcionais, como de costume. 

O pardmetro A é 0 endereco; ele indica a posicao de memoria inicial da imagem binaria a ser 
guardada. O endereco pode ser uma constante decimal ou hexadecimal. Os valores hexadecimais 
devem ser precedidos pelo sinal délar ($). Os valores decimais devem estar entre 0 e 65535. Valo- 
res negativos sdo proibidos. 
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O paradmetro L especifica 0 comprimento da imagem binaria a ser gravada. O comprimento é 
expresso em numero de bytes. Pode ser um numero decimal ou hexadecimal, com os valores hexa- 
decimais precedidos pelo sinal de ddlar ($). O comprimento vai de 1 a 32767 ou a mensagem 
SYNTAX ERROR sera gerada. 32767 é o maior tamanho que o DOS pode guardar num Unico 
campo. Devem ser dados dois BSAVE para guardar mais de 32767 bytes. 

Se as posic¢des de memoria na faixa especificada nado existem fisicamente, nenhum erro é 
devolvido. Nao é muito interessante especificar posicdes fora da faixa de memoria instalada no seu 
Apple II (exemplo, 49151 ou $BFFF em um sistema de 48K bytes). 


BLOAD 


O BLOAD recupera o contetido de arquivos binarios e os carrega na memoria. O comando BLOAD 
tem a seguinte aparéncia: 


BLOAD NOMEARG, AS7B,56,022U46 


O pardmetro endereco é opcional no comando BLOAD. Se ausente, a imagem é carregada inician- 
do no endereco especificado quando a imagem foi gravada. 

Os programas em linguagem de maquina podem n4o funcionar corretamente se forem carre- 
gados em enderecos de memoria errado. 

Diferentemente do comando LOAD, o BLOAD nao zera programas ou dados a menos que 
eles residam nas posicdes de memoria onde a imagem sera carregada. Apenas aquelas posicdes sao 
afetadas pelo BLOAD; outras posicdes fora da faixa do BLOAD nao sao afetadas. 

Nao é mostrado nenhum tipo de erro se o endereco referenciado para o BLOAD é uma 
area de ROM. A drea de ROM no caso n€o sera afetada, é claro. 


BRUN 


BRUN é idéntico ao BLOAD exceto que apds o arquivo ser carregado, co BRUN executa um salto 
em linguagem de maquina para o endereco inicial do programa. Se nenhum endereco é dado, o 
salto é para o endereco dado quando da gravacdo do programa. Aqui segue um exemplo do BRUN: 


BRUM MOMEARG. ASFS, 54,0226 


Nunca use o BRUN com imagem grdafica, pois o resultado é imprevisivel. 
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Graficos e Som 


O Apple Il tem capacidade de video grafico e geracdo de som. Juntas, essas caracter{sticas dao 
outra dimensdo aos programas que se usam e que se escrevem. Este capitulo é dirigido aos inician- 
tes que estao aprendendo BASIC (talvez apenas lendo este livro), bem como a programadores em 
assembler. Os graficos nao sao dificeis de serem montados, especialmente em linguagem de alto 
nivel. O Monitor do Apple II, com suas sub-rotinas em linguagem assembler incorporadas, ajuda 
ainda mais os programadores em linguagem assembler a usarem graficos e 0 alto-falante interno do 
equipamento. O intuito deste capitulo é que, ao terminda-lo, tenha-se sdlidos conhecimentos no 
emprego destes elementos nos programas. 


GRAFICOS DE BAIXA RESOLUCAO 


O Apple II tem duas d4reas de memoria separadas disponiveis para graficos de baixa resolucao. 
Estas duas dreas sdo chamadas paginas. Ambas as paginas podem aparecer na tela como grafico 
de video com 40 colunas por 48 linhas, como mostrado nz Figura 6.1. 

Cada coordenada (intersecdo de linha e coluna) aparece como um pequeno retangulo na 
tela. Cada pagina contém 1920 coordenadas (40 colunas vezes 48 linhas), e pode-se atribuir uma 
das 16 cores a cada coordenada em cada pagina. A Tabela 6.1 mostra os tons disponiveis. Ndo é 
necessdrio conhecer os fundamentos do funcionamento interno do Apple II para usar graficos 
de baixa resolucao; apenas o conhecimento de programacao em BASIC (e um pouco de coorde- 
nadas graficas) é suficiente para iniciar. 
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FIGURA 6.1. Tela de Grafico de Baixa Resolucao. 


TABELA 6.1. Cores de Graficos em Baixa Resolucao. 


Marrom 
Laranja 
Cinza #2 
Rosa 

Verde Claro 
Amarelo 
Agua 
Branco 


Preto 
Magenta 
Azul Escuro 


Purpura 
Verde Escuro 
Cinza #1 
Azul Médio 
Azul Claro 


NOOR WN - CO 





MONTANDO A PAGINA GRAFICA 


A pagina dedicada a graéficos de baixa resolu¢ao também dobra como a pagina de texto para o 
Apple II. Dentro do BASIC, muda-se para modo grafico a partir do modo texto através da decla- 
racao: 


Ink 
Uma vez executada a declaracdo, a tela fica preta a excecdo das quatro linhas inferiores da 
tela que recebem texto. Essa 4rea inferior da tela 6 chamada janela de texto. Com a janela de 
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texto na parte inferior da tela, existe espaco para 40 das 48 linhas disponiveis no modo grafico 
de baixa resolucado. Pode-se usar esta declaracao mais de uma vez dentro de um programa, mesmo 
estando dentro do modo grafico de baixa resolu¢do, o que resulta na limpeza da tela. 


Graficos de Tela Inteira 


Apos executar a declaracdo GR, pode-se eliminar a janela de texto e permitir que as oito Gltimas 
linhas sejam usadas para grafico, digitando: 


POKE ~16302,0 


A janela de texto desaparece, substituida por area de grafico. 


Refazendo a Janela de Texto 


Se o Apple II estiver no modo grafico total, pode-se fazer voltar a janela de texto de duas formas. 
Para limpar a tela grafica e voltar a janela de texto ao mesmo tempo, use a declaracdéo GR. Para 
voltar a janela de texto sem alterar as primeiras 40 linhas de grafico, entre a declaracao: 


POKE -~163017,0 


Uma vez executada, esta declaracdo rep6e a janela de texto em baixo da tela. 


Voltando ao Modo Texto em toda a Tela 


Para deixar 0 modo grafico de baixa resolucdo e voltar ao modo texto normal, use a declaracdo 
BASIC: 


TEAT 


isso faz voltar de grafico para caracteres. Enquanto a declaracdo GR limpa a tela quando executa- 
da, o TEXT nao limpa. Lembre-se que texto e grafico usam a mesma drea de memoria. Quando 
esta declaracado é executada, provavelmente a tela aparecera cheia de caracteres impares; isso é 
porque o Apple II estara interpretando os caracteres graficos como texto. Limpe a tela com a 
sequiéncia Esc-@, com a declaracao CALL-936 ou, em Applesoft, com 0 comando HOME. 


DECLARAGOES DE PROGRAMACAO DE GRAFICOS 


Tanto o Integer BASIC quanto o Applesoft reconhecem comandos graficos de baixa resolu¢ao 
para desenhar coordenadas na tela, trocar as cores usadas nos desenhos, e tracgar linhas horizontais 
e verticais de varios tamanhos. Estes comandos operam apenas em graficos de baixa resolucdo da 
pagina 1 (também chamada pagina primaria). Se for usada a pagina 2, varias dessas declaracdes que 
poupam tempo sao eliminadas e deve-se recorrer as declaracdes nao especificas, como PEEK, 
POKE e CALL para resolver os problemas. 


GRAFICOS E SOM 199 


A Declaracao COLOR 


Na Tabela 6.1, cada cor listada tem um ntmero correspondente entre 0 e 15. Esse é o numero 
usado na declarag¢do COLOR para indicar a cor atual do grafico de baixa resolu¢do. Por exemplo: 


COLOR 43 


indica que a cor do desenho sera amarela. Se nao for indicada a cor a ser usada, o Apple II usa o 
preto, equivalente a COLOR=0O, a cor adotada por auséncia. Embora se possa especificar um 
numero de cor entre 0 e 255 sem gerar erro de sintaxe, o COLOR toma apenas o nibb/e de menor 
valor selecionado. Dessa forma, se for dado COLOR=222 (igual a DE hexadecimal), sera enten- 
dido COLOR= 15 (igual a OE hexadecimal). 


A Declaragao PLOT 


Esta declaragdo BASIC coloca um Unico ponto grafico — um pequeno retangulo — na tela do 
Apple I! na coordenada que se especifica. 
A declaracao: 


PLOT S33, 18 
ilumina um ponto na 244 linha e 194 coluna na cor indicada pela Ultima declaragdo COLOR 
executada. O numero da linha vai de 0 a 47 e o da coluna de 0 a 39. Excedendo estes limites na 
declarag¢do PLOT, aparece uma mensagem de erro, e 0 programa para. Como em qualquer outra 
declaracao de grafico em baixa resolucdo (exceto GR), podem-se trocar expresses literais por 
variaveis: 


PLOT Y/24+12,xX-4 


oo” 


Um Exemplo de “’Plotagem” 


O exemplo seguinte em Integer BASIC usa todas as declaracdes graficas de baixa resolucdo vistas 
neste capitulo até aqui. O objetivo é desenhar uma linha diagonal a partir do canto superior 
esquerdo até o ponto direito mais baixo possivel. 


FO REM TRACA UMA LIMHA DIAGONAL 

TT REM PELA TELA EM BAIAA RESOLUCAO 
ef) GR 

20 COLOR= RND ¢14) 

4) FOR Y=0 TO 39 

90 PLOT Ys¥ 

60 NEAT ¥ 

7 GOTO 30 


A tela se parecera com a Figura 6.2, a menos da linha diagonal, que mudara de cor aleato- 
riamente. 
Para mudar o programa para Applesoft, troque a linha 30 como visto abaixo. 


30 NOLOR= RND (14) * 4é 
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FIGURA 6.2. Exemplo de Desenho em Baixa Resolucao. 


Tragando Linhas Horizontais 


O comando HLIN permite desenhar linhas de varios comprimentos da esquerda para a direita na 
pagina grdafica de baixa resolucdo. Esta declaracao: 


HLIN 0,397 aft 0 


desenha uma linha horizontal na parte mais alta da tela, da margem esquerda até a margem direita. 
HLIN lembra Horizontal Linha. A forma geral desta declaracdo é colocar a coluna esquerda seguida 
por virgula, seguida pela coluna mais 4 direita a ser ocupada pela linha (neste caso 39), a palavra 
AT, ea linha onde sera desenhada a reta horizontal. 

Os numeros de coluna da esquerda e direita colocados ndo podem ser negativos e devem ser 
menores que 256; o numero da coluna da direita nado pode ser menor que o da esquerda. O para- 
metro a frente do AT nao pode ser negativo nem maior que 48. Se algum desses parametros exce- 
der o limite, aparece uma mensagem de erro, interrompendo a execucao. Se for especificada coluna 
maior que 39 na declaracdo HLIN em Integer BASIC podem aparecer resultados imprevistos. O 
Applesoft fornece uma mensagem de erro. Por exemplo, execute a declaracdo: 


TW IR 
20 COLOR=12 
30 HLIN 45,7100 Af OQ 


Em Integer BASIC, isso causa 0 aparecimento de duas barras verdes. A primeira barra nao 
esta na linha O (a mais alta da tela) como deveria estar, e a barra continua por varias linhas tela 
abaixo. Em geral nado é bom fazer esses valores excederem os limites de posicdo na tela em baixa 
resolucao. 
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Tragando Linhas Verticais 


A declaracéo VLIN (de Vertical Linha) desenha uma reta na cor selecionada, de uma linha até 
outra, numa coluna especificada. 
Por exemplo: 


VLIN T2230 AT 32 


desenha uma reta da linha 12 até a linha 30, na coluna 33. Os valores dos parametros do VLIN sao 
idénticos aos de HLIN: a primeira e segunda expressGes devem ser numeros inteiros entre 0 e 255 
inclusive; o segundo pardmetro nado pode ser menor que o primeiro, e o Ultimo pardmetro (refe- 
rente ao numero de coluna) deve ser inteiro entre 0 e 39 inclusive. Se qualquer desses parametros 
estiver fora da faixa permitida, aparece uma mensagem de erro na tela do Apple II. 


Usando HLIN e VLIN num Programa 


Um outro programa (listado abaixo) ajuda a compreender o uso de HLIN e VLIN. Aqui, sao 
tracadas linhas aleatérias em cores aleatorias na tela. Para parar o programa, digite CTRL-C. 


TO REM USO DE VLIN E HLIN 

ZO GR © USA PAGINA GRAFICA 1 

30 POKE -16302,08 REM DET.PAGINA INTETRA 

4f) CALL -1998: REM LIMPA TODAS AS 4&6 LINHAS 
SO REM INICIO BO PROGRAMA 

40 COLORs RND €16)5 REM SELEC.COR ALEATORIA 
PQ HLIN O-RND €40) AT RAND ¢ 48) 

SW) COLOR= REND ¢€14) 

SO VLIN O, RAND €48) AT RND ¢40) 

YOO wotro 460 


A Declaragao SCRN 


A declaracéo SCRN é um tanto mais sutil que as outras declaracdes em baixa resolucao. Suponha 
que se deseje que o computador informe que cor esta desenhada num certo ponto da tela. O SCRN 
faz isso. Esta declaracao: 


R=OCRNC 12,24) 


atribua a variavel X o nUmero da cor na coordenada entre parénteses (neste caso, linha 13 e coluna 
25). A cor devolvida para a varidvel esta entre 0 e 15; o numero corresponde a uma das cores 
mostradas na Tabela 6.1. Por exemplo, se forem dadas as seguintes declaracodes em modo imediato: 

3k 

(POL OR = 1 4 

PLOT t2-12 

PRINT SOCRN C12+12) 
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O Apple I! responde: 
14 


Esta declaracdo pode ser muito util ao se escrever programas avancados em baixa resolucdo. 


GRAFICOS DE ALTA RESOLUCAO 


O aspecto mais atraente do Apple || é sua capacidade de fazer graficos em alta resolucao. Como no 
caso dos de baixa resolucdo, existem duas areas ou paginas disponiveis para uso. Mas é apenas 
nisso que reside a similaridade. A resolucao neste modo é de 280 linhas horizontais por 192 posi- 
cdes verticais, um incremento de 7 vezes na vertical e 4 na horizontal sobre o modo de baixa 
resolucdo. Entretanto, existe menor nimero de cores possivel e pode-se desenhar linhas muito 
mais finas na tela. 

As funcdes internas disponiveis para graficos em alta resoluc¢ado existem no Applesoft. O 
Integer BASIC nado tem comandos especificos desse tipo. No entanto, nao importando a linguagem 
usada no Apple II, existe a capacidade grafica de alta resolucdo porque o Apple II usa parte da 
memoria para guardar pontos, linhas e formas de alta resolu¢dao, e usa programas internos para 
interpretar e apresentar na tela esses dados. Certas declaracdes internas do Applesoft usam os 
programas internos automaticamente e a memoria da tela; essa parte sera vista em primeiro lugar. 
Mais adiante veremos como incorporar grdficos de alta resolucao também aos programas em 
Integer BASIC. Como sera visto adiante, existem algumas fun¢des de alta resolucdo que s6 sao 
possiveis em Integer BASIC. 


QUE PAGINA DEVE SER USADA? 


Existe alguma dificuldade em se usar graficos de alta resolucao, e elas envolvem a quantidade de 
memoria de que o sistema dispde. Se estiver sendo usado o Applesoft firmware (isto é, em ROM 
no Apple Ii Language System), pode-se usar a pagina 1 de alta resolucdo se o computador possui 
mais de 16K, e pode-se usar a pagina 2 se o Apple || tem 24K ou mais. Ponha mais 12K se for 
usado o Disk Operating System (DOS) e o grafico de alta resolucao do Applesoft em conjunto. 

Se for usada a versdo do Applesoft em cassette ou disco, ndo se pode usar a pagina 1, por 
esse espaco ser empregado no interpretador do Applesoft. Ao se tentar usar a pagina grafica 1 
de alta resolucao nesse caso, estaré comprometida ou completamente perdida a possibilidade de 
programacdo em Applesoft bem como o programa BASIC presentemente na memoria. Pode-se 
usar a pagina 2 se o Apple I! tiver pelo menos 24K, ou 36K se o DOS estiver presente ao mesmo 
tempo. 


Reservando Memoria para Graficos de Alta Resolucao 


O Apple II ndo reserva automaticamente espaco de memoria para grdficos de alta resolucdo. A 
medida que o programa vai ficando maior, por aumento do numero de declara¢des ou de varia- 
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veis, a chance de destruir paginas graficas aumenta. A forma de resolver este problema é determinar 
dois ponteiros de memoria, HIMEM: e LOMEM:, os valores que vao proteger a pagina ou paginas 
graficas de alta resolucao usadas. Esses ponteiros agem como limites que o programa nao pode 
ultrapassar, permitindo assim a existéncia de até duas dreas de memoria que podem ser usadas 
livremente. 

O uso do HIMEM: e do LOMEM: difere entre o Applesoft e o Integer BASIC. Veja as dife- 
rencas no compéndio de BASIC, localizado no Capitulo 8. Veja também a Figura G.1 no Apéndice 
G que mostra o uso de memoria em forma de desenho. Os trés paragrafos que seguem ficarao mais 
faceis de serem entendidos se forem observadas essas indicacoes. 

Se for desejado usar pagina grafica de alta resolucao 1 (lembre-se de que é necessario ter-se 
o Applesoft em firmware para isso), tendo apenas um Apple || com 16K, ponha HIMEM: em 8191 
e nado mexa no LOMEM. Isso fara com que o programa em Applesoft se mantenha abaixo da posi- 
cao de memoria 8191, o que é uma severa porém necessaria restricdo, desde que se necessita 8K 
para memoria grafica de alta resolucdo. Se for o caso de se usar pagina 1 num Apple || com mais de 
16K, pode-se também nado mexer no HIMEM: e colocar o LOMEM: com 16384. Isso colocara o 
programa acima da pagina grafica de alta resolu¢ado 1. CUIDADO: Nao use este esquema em 
conjunto com o DOS a menos que o sistema tenha mais de 32K de memoria. Caso contrario, use 
O primeiro esquema, que mantém o programa abaixo da pagina 1. 

Se se deseja usar a pagina 2 (possivel apenas com 24K ou mais), ponha LOMEM: em 24576, 
ou HIMEM: em 16383 deixando LOMEM: inalterado. Ajustando LOMEM: coloca-se o programa 
do Applesoft acima da pagina grafica 2. Para usar o DOS ao mesmo tempo, é necessdrio no minimo 
48K de memoria. Se for ajustado o HIMEM: o programa residira abaixo da pagina grafica 2. Neste 
Ultimo caso, em se usando o interpretador Applesoft nao-firmware (a partir do cassette ou disco), 
O programa em Applesoft ficaré no espaco acima do interpretador e abaixo da pagina grafica 2, 
que é um espaco apertado. 

No caso de usar ambas as paginas para grafico de alta resolucao (possivel apenas com o 
Applesoft em firmware), ponha LOMEM: em 24576 e HIMEM: em 8191. Se o programa em 
Applesoft é colocado acima das paginas graficas, ajustando o LOMEM: e deixando o HIMEM: 
entdo é necessdrio no minimo 48K para usar o DOS e ainda ter uma quantidade de memoria razoa- 
vel para o programa em Applesoft. 


ACESSANDO O DISPLAY GRAFICO 


Embora haja disponibilidade para duas paginas grdficas de alta resolu¢ao, o Applesoft em disco ou 
cassette usa parte da pagina 1 para armazenar a linguagem (o interpretador). Tendo o Apple I! Plus 
ou o standard, ambos com o cartaéo Applesoft Firmware ou o Language System, pode-se usar a 
pagina 1 sem receio de alterar o BASIC. Para efeito de compatibilidade com outros computadores 
Apple II, pode-se usar apenas a pagina 2 em qualquer caso. 

Em Applesoft, a declaracao: 


HGR 


limpa a tela e mostra a pagina grafica 1, com quatro linhas de texto na parte baixa. Pode-se ter 
grafico e texto na tela com este modo usando declaracdes PRINT em Applesoft para mostrar 
texto na janela de texto. Entretanto, uma vez executado o HGR pelo Apple II, a tela apenas mos- 
tra 160 das 192 linhas grdficas horizontais de alta resolucdo disponiveis. Para mostrar a tela grafica 
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inteira, execute POKE-16302,0 apds o HGR. Isso eliminara a janela de texto trocando-a pelas 32 
linhas grdficas restantes. 
Para mostrar a pagina de alta resolucdo 2, use a declaracdao: 


HGR 


A execucao do HGR2 limpa a tela e mostra todas as 192 linhas da pagina grafica de alta 
resolucao 2, sem deixar janela grafica em baixo da tela. Para abrir a janela de texto use POKE- 
16301,0 apds o HGR2. A janela de texto é mais dificil de se usar na pagina grafica 2. O texto que 
aparece na janela provém da pagina de texto secundaria. O BASIC sé pode acessar essa pagina 
através de declaracdes POKE (nao via PRINT), 0 que é um limite. Entretanto, a segunda pagina de 
texto ndo é protegida contra escrita no BASIC como a primeira, de forma que é preciso colocar 
LOMEM: em 3071 ou mais. 


ALTERNATIVAS PARA O HGR E HGR2 


A principal desvantagem em se usar HGR e HGR2 6 que em se executando qualquer dessas decla- 
racdes limpa-se a pagina grafica de alta resolucao, quer se queira ou nao. Além disso, essas decla- 
racGes nao estado disponiveis em Integer BASIC. Pode-se usar declaracdes PEEK, POKE e CALL 
para tornar as paginas grdficas mais flexiveis, e elas podem ser Uteis nado importando qual a lingua- 
gem usada no Apple II. 


Outra Forma de Gerar Display Grafico 


E possivel ir-se para o modo grafico de alta resolucdo sem limpar a tela. Pode-se comparar este 
método ao acionamento de chaves. Teoricamente, o que se faz é exatamente isso, numa area de 
memoria reservada, chamada chave de software, que se localizam de —16304 até —16297 ($C050 
até $C057). A Figura E.1 do Apéndice E ilustra as chaves disponiveis. Para manter essas decla- 
ragdes compativeis com Integer BASIC e Applesoft, usamos a representacao inteira negativa 
dessas posi¢des de memoria, (ou seja, —16304 ao invés de 49231). 

Para mostrar a pagina grafica de alta resolucdo 1 sem limpar o contetido anterior, execute as 
seguintes declaracdes: 


POKE -14204,0 Entra no modo grafico 
POKE -%4297,0 Entra no modo alta resolucdo 
FOKE --14'300,0 Seleciona pagina 1 de alta resolucao 
(Necessdrio apenas quando se troca da pagina 2 para a 1) 


Tente essas declaracdes em modo imediato como experiéncia. 
Para mostrar a pagina 2 de alta resolucdo, sem alterar o contetdo anterior, entre as seguintes 
declarac6es: 


POKE -4&314,0 Necessdrio apenas se modo grafico ainda nao foi selecionado 
POKE -T&29 7,0 Necessdrio apenas se modo alta resolucdo ainda nao foi selecionado 


POKE -T4299,0 Seleciona pagina grafica de alta resolucdo 2 
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BASIC Normal apés Gradfico em Alta Resolucgao 


Em Integer BASIC, as declaragcdes TEXT e GR podem ser insuficientes para limpar a tela. Em usan- 
do a pagina grafica 2, deve-se re-selecionar explicitamente a pagina 1 com uma declaracao POKE- 
16300,0. De outra forma o que se vera sera a pagina de memoria 2 de texto e grafico em baixa 
resolucdo. Isso pode ser especialmente confuso em modo texto. O teclado parece nao ter funcdo 
pois tudo o que se digita vai para a pagina de memoria 1, enquanto o que esta sendo mostrado é 
a memoria da pagina 2. 

A declaragdo GR nado mudou de alta para baixa resolucao grafica em Integer BASIC. Ela 
apenas seleciona modo grafico com a janela de texto de quatro linhas (em oposi¢ao a modo texto 
inteiro). Deve-se selecionar explicitan'ente grafico em baixa resolu¢ao com uma declaracao POKE- 
16298,0. 


Limpando as Paginas de Alta Resolucdo 


Usando graficos de alta resolucéo em Applesoft, HGR e HGR2 limpardo a pagina sempre que a 
declaracao é executada. Entretanto, sob Integer BASIC nao ha declaracao simples que execute 
esta funcdo. A sub-rotina seguinte usa uma funcao interna do Monitor para limpar a tela de alta 
resolucao: 


TEP SO REM Fe oe wi we oe ee We Se OE 96 EE 50 2 EEE EE HE EE 
TSee 1, REM # LIMPA TELA DE ALTA RESOLUCAG ¥ 
TBESS REM #* CUSA SUBROTINA “MOVE” DO MONTTOR 
TeUeoS REM &% EM €FESC PARA MOVER DADOS RAPIDA- * 
TOS94 REM # MENTE PELA AREA DE ALTA RESOLUCAO # 
4 3 S & 4 f- 4 Qe vee mee mee meee meee ee mee ete mee ee cnet mee eer ee snes mee epee tees mee cee nee eeee mee meee mee ate meee nee ents eee nee meee tee Ph 
1Ta¢?4S REM * ENTRE EM PAGINA 1 OU 23 A ROTINA * 
1997 REM *# FAZ O RESTO. ¥ 
“PEEPS PEM 3e Fe 9G 36 9G Me ee 9 FE EE HEE SE HE SE a HE FE HE SE HEHE 3 EE 


1PONOO INICLO=32 

19010 LF PAGINAs=2 THEN INICIO=44 
19020 POKE 8 

17020 POKE » INICIO 

19040 POKE ey 

49050 POKE 423, INICIO+33 

790460 POKE 466,14 

419070 POKE 67,INICIG 

{O80 POKE ~14304,0 

13090 POKE -14297.-0 

49400 LF PAGINA=1 THEN POKE ~146200,0 
494410 IF PAGING=1 THEN POKE -14299,0 
T2120 POKE INI lox]2546,0 

19430 CALL ~468 

19440 RETURN 


Esta sub-rotina em BASIC move zeros para a pagina grafica em alta resolucdo selecionada. 
Se a varidvel PAGINA é posta em 1, a sub-rotina limpa a pagina 1; se posta em 2, a pagina 2 é 
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limpa. Esta rotina funciona apenas em Integer BASIC; entretanto, nado considere isso uma des- 
vantagem. O Applesoft executa esta funcdo de forma muito mais eficiente com HGR e HGR2. 


CORES EM ALTA RESOLUCAO 


Sdo disponiveis oito cores em modo grafico de alta resoluc¢do, porém apenas quatro cores dife- 
rentes sdo permitidas, mais o preto e branco. A Tabela 6.2 mostra essas cores e seus numeros 
correspondentes (usados na selecdo da cor). 


TABELA 6.2. Cores Grdficas em Alta Resolucao. 


Preto Preto 


Verde Laranja 
Violeta Azul 
Branco Branco 





A Declaragado HCOLOR 


A declaragdo HCOLOR do Applesoft seleciona uma das oito cores disponiveis para uso em alta 
resolucdo. Diferente da declaracdo COLOR em grdficos de baixa resolucdo (que permite especi- 
ficar nimeros maiores que aqueles alocados para cores), o HCOLOR no aceita cor maior que 7. 
Se uma cor fora do limite é especificada, o programa para abruptamente com a mensagem 
?7ILLEGAL QUANTITY ERROR. O HCOLOR néo troca a cor de graficos ja presentes na tela, 
nem tem qualquer efeito em graficos de baixa resolucdao. 


Determinando a Cor de Fundo em Alta Resolucao 


Com uma pequena modificacao, a sub-rotina apresentada antes de limpa a tela ira preenché-la 
inteiramente com uma das cores disponiveis. A sub-rotina abaixo faz isso. Antes de chaméa-la, 
determine a pagina grafica através do uso da variavel PAGINA. Ainda, determine o niimero da cor 
pela variavel HCOR. O programa que chama deve atuar nas chaves de software para modo grafico 
de alta resolucdo. Esta sub-rotina opera apenas em Integer BASIC. 


{ABs OD REM BHM AMHR HMR 
18991 REM # GERA COR DE FUNDO # 
“| £3 t o> fe 4 fe f. M at Ghai Madp) olee,iehub, Sawn iinten “does binb, baa eats; thin) dase shee sabeb lncse-eine eons H 
18993 REM * DET.PAGINA=1 OU 2 x 
T6894 REM #® FE HCOOR COM A COR % 
16995 REM * EQUIVALENTE f3Q % 
189964 REM # APPLESOFT. # 
YHSESP REM KEM MRMRUKKKRNRMKHMH KRM 
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{9000 INICIO=32 
190410 IF PAGINA= 
{9N2O POKE 40,0 
49020 FOKE 61, INICIO 

49040 POKE 62,253 

19050 POKE 43,TNICI0O+23 

49060 POKE 6672 

49070 POKE 47,INICIO 

49075 Yi=85: X1=42 

49080 IF HCORDO AND HCOR<34 THEN 19090:xX4=02Y4=0 
49090 IF HCOR<>3 AND HCOR4>7 THEN 49400:X4=127:Y1=127 
419100 IF HCOR#1 OR HCOR=S THEN 19420 

49410 XB3=X49¥42 12 Y= X3 

49420 IF HCOOR<4 THEN 19140 

19430 YAH¥441289X4=xX144128 

19140 POKE INICTO*256,x1 

(E150 POKE INICTOne5é+1- 14 

12140 LF PAGINA=1 THEN POKE -16300,0 

19470 [F PAGINA=2 THEN POKE ~16299.0 

494780 CALL ~468 

19490 RETURN 


2 THEM INICTO=64 


DESENHANDO PONTOS E LINHAS 


Uma vantagem poderosa dos graficos de alta resolucao em Applesoft é sua habilidade de desenhar 
linhas de qualquer Angulo bem como pontos isolados e linhas horizontais e verticais. A declaracao 
HPLOT pode ser usada de trés formas: 


HPLOT t2-42 


Isso desenha um ponto na pagina de alta resolucdo corrente na intersecdo da décima-terceira linha 
com a décima-terceira coluna, na cor de alta resolucdo selecionada. 
O segundo uso do HPLOT é: 


HPLOT 0,0 TO 279,191 


Esta declaracdo desenha uma linha diagonal do ponto mais alto a direita até o mais baixo canto a 
esquerda na tela. Usando HPLOT com dois conjuntos de coordenadas como mostrado acima, pode- 
se desenhar uma linha de um ponto a outro da tela. O terceiro tipo é mais sofisticado: 


HPLOT 0-0 TO 279,0 TO 279, 191 TO 0-191 TO 0,0 


Esta versdo do HPLOT s6 opera na versdo firmware do Applesoft. As versdes em disco e cassette 
ndo permitem esta forma de HPLOT. Aqui se pode definir multiplas declaragdes do HPLOT 
facilmente. Todos os segmentos sao desenhados na mesma cor. Isto pode ser Util ao se desenhar 
formas de varios lados. 


Alternativas ao HPLOT 


APPLE II 


A sub-rotina listada abaixo permite programar graficos de alta resolucdo em Integer BASIC, sem 
necessidade de comutar paginas. Esta rotina pode ser Util, embora seja lenta em vista de todos os 
calculos serem feitos em BASIC. Para usd-la passe as coordenadas X e Y do ponto desejado. Certifi- 
que-se que PAGINA contém a pagina desejada. Fica a seu cargo determinar os modos de alta 
resolucdo, grafico e tela cheia. Isso permite flexibilidade adicional. Se 6 permitido usar esta rotina 
sem indicar antes o modo de alta resolucdo, a sub-rotina operard na memoria de alta resolucdo, 
mas sem modificar a tela. Em seguida, depois do programa modificar a area de memoria, ele podera 
entrar em modo grafico de alta resoluca€o com uma série de declaragcdes POKE (como foi descrito 
antes) e toda a operacdo de desenho leva a efeito fora de cena aparecera subitamente. Isso permite 
ao programa apontar a pagina 2 enquanto mostra a pagina 1 e vice-versa. 


Um Exemplo de Alta Resolucao em Integer BASIC 


O programa seguinte usa duas das sub-rotinas recentemente introduzidas para desenhar pontos em 
telas de alta resolucdo. Controladores de jogos determinam a coordenada a desenhar. Rodando os 


controladores, obtém-se linhas na tela. 


POO OD EM He ie we ae we He eee ee FE Fe FEE HE EK FE EW Se Ee a 9 GE EE 
20001 REM * DESENHO EM INTEGER ALTA pene ¥ 
Sh? BOM SF sccm nmaongn nun annem emo % 
2QNN03 REM * [NDTQUE X=RIOLUNA, ToLINHaA . it 
eQN04 REM * PAGINA=1 OW 2: USA AS VaR TAVETS % 
eUGG> REM © Y¥1+X1 E X23 * 
POODG EM We a WW de Se 40 46 36 WE 4E 5G 3E SE FE FE HE 3G SE NE HE E36 EE a 9 a 
LOOO7 REM 

Z2OOTO YI=PAGINAXB1Te82: REM DET. ENDERECO BASE 
SOO20 Ye ¥ie oy 4443e4040Y MORE wTNS 

20030 YrRHV¥i+cy MOD 44/88 128+%/7 

20040 X1=PEEK CY1)5 REM LE NO BYTE ALTA RESOL. 
20050 X3=e2" (xX MOD 7) 

20060 REM ’OR’ DO BIT EM X1 COM 

20070 REM O VALOR DO BIT EM X3 

20080 IF X41 MOD ¢€X3 ” 224 *3 THEN X1=X174X3 
2O0090 POKE Y14s+X3 

“O10U KT = PEEK “<¥43 

21040 X23 = 2 CX MOD 7) 

27020 IF K1 MOD (XSe2)<XS THEN X1=497X%3 

21025 AS = 2 ™ €X% MOD 72 

2eigdes GOTO 21100 

21030 POKE Y¥42X3 

1040 RETURN 

“21100 PORE Y¥t¢Ks 

21130 RETURN 

29000 GOSUB ASO 
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10 REM ESTE PROGRAMA USA ROTINAS 

20 REM ESPECTAIS PARA LIMPAR E DESENHAR 
20 REM EM GRAF ICOS DE ALTA RESOLUCAO 
40 REM USE CTRL-C PARA FINALIZAR 

89 REM GERA MODO GRAFICG 

ON POKE -16304,0 

O REM GERA GRAFICO DE ALTA RESOLUCAO 
10 POKE -162¢7,0 

109 REM DETERM.GRAFICO EM TODA A TELA 
11 POKE ~14302-0 

200 PAGINAS2 

204 REM LIMP@ MEMORTA DE ALTA RESOLUCAO 
205 GOSUR 190n0 


209 PEGA COORDENADAS LOS PONTOS 
2410 X= PDL €4) 
220 Y= PDL ¢O) 


ee? REM DESENHA PONTO BE ALTA RESOLUCAD 
“70 GOSUB 20010 

2aoF REM PEGA MAIS COORDENADAS 

240 GOTO 210 

awl END 


Para uma variacao interessante deste programa, tente usar a sub-rotina que preenche a tela de uma 
cor ao invés de limpar a tela. 

Tente melhorar o programa verificando os botdes do controlador de jogo com declaracées 
POKE, e limpando a tela a cada vez que o botao é acionado. 


USANDO FORMAS EM ALTA RESOLUCAO 


Juntamente com desenhos e tracos, o Apple II permite definir desenhos e manipular formas de 
duas dimensdes em modo grafico de alta resolucdo. Esta secao ensina como criar, projetar e usar 
uma forma sob o Applesoft. Tanto quanto possivel, esta secdo apenas inicia a exploracao das pos- 
sibilidades de criagao que sao abertas. 

Até agora vimos como gerar um programa que desenha graficos em alta resolucao que faca 
figuras geométricas. Quem operou com esses programas provavelmente encontrou alguma dificul- 
dade em manipular as figuras na tela. Por exemplo, pode-se desejar rodar uma figura sobre um 
eixo, ou fazé-la aparecer maior ou menor na tela. As formas em alta resolucado tém essas possibi- 
lidades. 


DEFININDO FORMAS 


As formas em alta resolucao requerem planejamento. Em esséncia, faz-se mais que dizer ao compu- 
tador para desenhar uma linha do ponto A ao ponto B. Usando formas no Apple II, descreve-se 
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inteiramente a figura antes de orientar o computador para desenha-la. Definem-se formas em alta 
resolucdo numa tabela de formas, chamada assim por conter as caracteristicas codificadas da figura 
a ser desenhada. O primeiro passo para definir uma forma de alta resolucao é desenhar a propria 
forma num papel. Pegue o exemplo de desenhar um quadrado, que consiste de quatro linhas 
de igual tamanho, cada uma fazendo um angulo reto com a outra previamente desenhada. 


e—__—_—___—_~+ 


A tabela de forma contém instrucdes codificadas para desenhar uma figura; essas instrucdes 
sao chamadas vetores de desenho. Cada vetor descreve movimento de subida, descida, direita, 
esquerda, e ainda se o desenho vai para a tela ou nado. Pode-se interpretar cada lado do quadrado 
ilustrado acima como uma direcdo a desenhar: um para cima, um para a direita, um para baixo e 
um para a esquerda. Essa é a forma pela qual as rotinas de manipulacao de formas do Applesoft 
vé as figuras. 

Figuras sdo mais dificeis de se desenhar, se contém linhas diagonais ou curvas. Um triadngulo, 
apesar de ter um lado a menos que o quadrado, envolve muito mais trabalho porque contém no 
minimo uma linha diagonal. As linhas quebradas na ilustracao abaixo indicam movimento sem 
desenho (vetores fantasmas) : 


— os oo <K<{—--— - - 


= 
a 


Desde que se pode apenas definir uma forma com vetores que movem para cima, baixo e 
lados, algumas formas, como os circulos, podem nao ser nem aproximados. Em tais casos pode 
ser mais facil desenhar formas complicadas com o HPLOT ao invés de usar tabela de formas. 


MONTANDO A TABELA DE FORMAS 


A figura desenhada em papel deve ser convertida em vetores de desenho. Esta secao mostra como 
fazer a conversdo. A secao seguinte mostra um programa em Applesoft que faz a conversdo. 
Assim pode-se pular para a secao seguinte se nao houver interesse em saber como as tabelas de 
formas funcionam internamente. 

Os cddigos dos vetores tém valor entre 0 e 7; cada bit numa definicao de forma (parte da 
tabela de forma) pode ter até trés vetores. A Tabela 6.3 mostra os cédigos de vetores possiveis. 
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TABELA 6.3. Vetores de Desenho e seus Cédigos Bindrios. 


Cédigo Binario Cédigo Decimal 
000 


Move para cima sem desenhar 
Move para direita sem desenhar 
Move para baixo sem desenhar 
Move para esquerda sem desenhar 
Move para cima desenhando 
Move para direita desenhando 
Move para baixo desenhando 


NOOO B WN - CO 


Move para esquerda desenhando 





Uma vez que a forma foi reduzida a um conjunto de vetores, eles podem ser colocados na memé- 
ria, onde certos comandos em Applesoft os decodificam e desenham a forma. 

Peque um ponto inicial da forma. Faca uma lista de vetores de desenho necessdrios para 
construf-la, usando flechas (Tt, <, 1, >). Liste os vetores na ordem em que aparecem na forma 
(em diregdo aos ponteiros do relégio ou ao contrdrio, tanto faz). Marque qualquer vetor que deva 
ser gerado mas nao desenhado (vetores fantasmas). Iniciando no canto inferior esquerdo, nosso 
quadrado corresponde a estes vetores: 


* . 


_> 
4 
<_ 





Agora. escreva o cédigo bindrio na frente de cada vetor (use a Tabela 6.3 para converter). 
Obtém-se o seguinte: 





Como mostrado na Tabela 6.4, cada byte da tabela de tormas contém trés partes, cada uma 
das quais pode conter um vetor de desenho. Veja que as partes 1 e 2 contém trés bits cada e a 
parte 3 contém apenas 2 bits. 
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TABELA 6.4. Byte da Tabela de Formas. 


M = bit de movimento 


P = Desenha ou nao 





Olhando a Tabela 6.3, pode-se ver que alguns dos cédigos usados para desenhar sao ntimeros 
de 3 bits. Isso é correto para as partes 1 e 2 de cada byte de definicdo de forma, cada uma das 
quais tem trés bits. Na parte 3, por ter apenas 2 bits, ela sO pode ter certos vetores de desenho. Os 
vetores permitidos na parte 3 sao direita, esquerda, cima e baixo sem desenho. Nao sao reconhe- 
cidos outros vetores na parte 3. 

A maioria das vezes a parte 3 ndo é usada. Isso nado significa que se possa esquecer de usa-la 
para compor o todo, mas na maioria das vezes pode-se fazé-lo. Se a parte 3 da definicado de forma é 
deixada em zero, o Applesoft a ignora, indo para o byte seguinte e interpretando-o para compor o 
desenho. 

O vetor de desenho como zero pode significar duas coisas. Na parte 3 de cada definicado de 
forma, um vetor de desenho a zero sempre significa ‘‘sem movimento e sem desenho’’. Entretanto, 
na Tabela 6.3, um vetor zero significa ‘‘mover para cima sem desenhar’’. Essa ambiglidade pode 
Causar problemas nas partes 1 e 2 em cada byte de definicao de forma, porque sob certas circuns- 
tancias o Applesoft ignora vetores de desenho em zero, e em outras ele executa movimento para 
cima sem desenhar. A regra aqui é nunca terminar um byte de definicdo de forma com um vetor 
de desenho em Zero, se for desejado que esse vetor represente ‘“movimento para cima sem dese- 
nhar”’. As rotinas de manipulacdo de formas do Applesoft assumem que se a porcao mais signifi- 
Cativa (parte 3) ou as duas mais significativas (2 e 3) sao zero, ndo 6 executada nenhuma acdo de 
desenho. 

Se todas as trés partes do byte de definicdo de forma estiverem em zero, o Applesoft inter- 
preta como sinal de ‘fim da definicado de forma’. De fato, deve-se terminar cada definicdo de 
forma com um byte de terminacdo, igual a zero. De outra forma o Applesoft continua apos o fim 
da definicao da forma original, até encontrar um byte em O. 

Pode-se usar o vetor de ‘‘movimento para cima sem desenho” pois um vetor de desenho vem 
depois dele no mesmo byte. Por exemplo, a parte 2 pode ser posta em O (que significa ‘‘mover 
para cima sem desenhar) e se a parte 3 é deixada em 01, 10 ou 11 (bindrio), a parte 2 sera inter- 
pretada como ‘mover acima sem desenhar’’. Se a parte 3 é deixada em 0 e a parte 2 também, ndo 
ocorre nenhum movimento e o Applesoft vem na parte 1 do byte seguinte para procurar o vetor 
de desenho valido seguinte. 

Contando com esse conhecimento, pode-se agora montar os vetores de desenho em cddigo 
bindrio para cada segmento da forma em grupos de dois ou trés. Dessa forma, transformam-se os 
codigos dos vetores de desenho de trés bits para oito bits que podem ser guardados em memoria. 
Os vetores de desenho para o mapa do quadrado nas suas definicdes da forma sao mostradas 
na Tabela 6.5. 

Com a forma agora mapeada em bytes em codificacao binaria, pode-se facilmente converter 
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TABELA 6.5. Codificando a Tabela de Formas (Square Shape). 


Pte 1 Pte.2 | Pte. 3 | Pte. 1 Pte. 2 | Pte. 3 
> 
< 


Nada T 
Nada 1 
Nada Nada Nada 











Cédigos Hexadecimais 










00 100 101 25 
00 110 111 37 
00 000 000 00 





cada byte para notacdo hexadecimal. O Apéndice J contém uma tabela de conversao de binario 
para hexadecimal. A Tabela 6.5 mostra a codificacao hexadecimal do quadrado. 

A definicdo de forma agora esta completa. O préximo passo é criar uma série de apontadores 
para essa forma (e outras — até 255 formas) que o Applesoft usa como diretoério. 


Montando o Diretério da Tabela de Formas 


O diretorio da tabela de formas é uma série de bytes que descrevem quantas formas existem na 
tabela, e também aponta cada definicao de forma na tabela. O primeiro byte do diretorio contém 
o numero total de formas da tabela. Este nimero vai de 0 até 255 ($FF). O segundo byte ndo é 
usado e pode ser colocado em zero. 

Os bytes restantes no diretdrio contém apontadores para cada definicao de forma existente 
na tabela. Cada apontador tem dois bytes de comprimento e contém o deslocamento (distancia 
absoluta em bytes) da forma a partir do /n/cio do diretorio. O byte de menor ordem do apontador 
precede o de maior ordem. Por exemplo, se o deslocamento em uma forma é 10 bytes, codifica-se 
em hexadecimal como OAOO. No caso do quadrado, existe apenas uma forma para listar no dire- 
torio, de forma que o deslocamento da forma 1 para o diretdrio é quatro bytes. Assim, 0400 
vai para essa parte do diretorio. 


Bytes 
0 01 ————— Ndmero de formas da tabela 
1 02 
2 04 Deslocamento da forma 1 do byte 0 
3 00 (byte de menor ordem primeiro) 
4 25 

«—————- Definicao da forma 

5 37 
6 00 ~<~———— Forma termina com 00 
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Diretério da Tabela de Formas 


Tabela de Formas 


APPLE II 


Deslocamento 


0 Numero de formas 
na tabela (0-$FF) 


Nao usado 
(em zero) 


Deslocamento da 
forma 1 
(byte de menor ordem) 

















Deslocamento da 
forma 1 
(byte de maior ordem) 






Deslocamento da O comprimento desta parte 
2i+ 2 forma j depende do numero de 
(byte de menor ordem) formas na tabela 
(2 bytes para cada uma) 





Deslocamento da 


2i+ 3 forma i 
(byte de maior ordem) 





: Vetor de desenho 
2i+ 4 da Forma 1 


Terminagéo da forma 
sempre com 00 





Vetor de desenho 
da Forma i 





FIGURA 6.3. Organizacaéo da Tabela de Formas. 
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E uma boa pratica deixar espaco extra em bytes no fim do diretorio da tabela de forma 
para dar espaco para apontadores de tabelas futuros. Se nado existe espaco no final do diretdrio 
para permitir expansdao, sera necessdrio reorganizar a tabela de forma inteira quando houver um 
novo apontador de forma para inserir. Mesmo que sO se necessite um diretério contendo dez 
formas, deve-se deixar espaco livre no final do diretorio; 20 bytes extra permitem mais dez aponta- 
dores de formas para uso posterior. Quando for necessaério colocar mais uma forma na tabela, 
coloque a nova definicdo apés a ultima feita na tabela, calcule o deslocamento para a nova forma a 
partir do inicio do diretério, coloque o novo apontador imediatamente apds o apontador da ultima 
forma do diretério, e some 1 ao byte 0 do diretério (que contém o nimero total de formas na 
tabela). 


A Figura 6.3 ilustra 0 modo como as tabelas de formas e seus diretérios sao organizados na 
memoria. 


Montando Vetores por Computador 


O programa seguinte, em Applesoft, monta uma definicao de forma. Ele pede que se digite cada 
vetor de desenho e se ele deve ou nao ser desenhado. Apos digitar o Ultimo vetor, digite ‘’F’’ (de 
FIM) e acione RETURN. O programa pergunta se algum vetor deve ser alterado. Caso tenha havido 
algum engano durante a digitacao de um vetor, digita-se novamente. 

Quando nao houver mais correcdes, digite 0 em resposta a VETOR PARA ALTERAR 
(O=FIM). Apds alguns segundos, os vetores de desenho sao apresentados em nota¢do hexadecimal. 
Aqui esta uma listagem do programa e um exemplo de sua atuacdo: 


2 REM * PROGRAMA DE CRIACAO DE FORMAS * 

10 DIM $1(100),¥1¢100) 

20 T= 0 

30 PRINT “CRIACAO DE VETORES DE FORMAS” 

40 PRINT 

41 REM DIGITACAO DAS ACOES DOS VETORES 

50 V = It GOSUB 270 

58 REM DIGITA-SE ATE M$ 

59 REM SER IGUAL AO VALOR “F* 

60 IF M$ <> “F” THEN S1(I) = Mt I = I + 42 GOTO 50 
70 PRINT 

71 REM PERMITE CORRECOES 

80 INPUT “VETOR PARA MODIFICAR (O=FIM)273¥ 

90 IF V > 0 THEN V = Y ~ 42GOSUB 270:S1(¥) = MzGOTO 80 
99 REM COLOCA VETORES NO ARRANJO Y410) 

100 FOR Y= 0 TOI 

110 IF B = 2 AND S1(¥) > O AND $1(Y) < 4 THEN 140 
120. IF B < 2 AND (S4(¥) > 0 OR S1(¥) > 4) THEN 140 
130 B=0: @= @+1 

140 V4C@) = V1CQ@) + S1CY) * (BB) 
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150 B= B + 1 

160 IF B > 2 THEN B = O02@ = Q@ + 1 

70 NEXT ¥V 

77 REM MOSTRA VETORES COMO NUMEROS HEXADECIMAIS 
180 PRINT “BYTE” «“VETOR” 

190 FOR YV = O TO @ 

2OQ HA = VIC) 4 16 

210 LA = V4ICY) ~ HA ® 16 

220 iF HZ * 40 THEN HA = HZ + 7 

eo TP U2 > TO THEN LA = LA t+ 7 

240 PRINT V>, CHRE (HA + 1769: CHRS (LA + 176) 
20 NEXT V 

260 END 

2&9? REM SUBROTINA DE ENTRADA DO VETOR 
270 PRINT “VETOR “FV + TRS" s 

2G INPUT “MOVIMENTO:® C/B/E/D? “SMS 
e970 M = 0 

3200 IF M& = “D” THEN M = 4 

310 IF M& = “BY” THEN M = 2 

320 IF MG = “E” THEN M = 3 

330 If MS = *F” THEN RETURN 

340 INPUT “DESENHO (S=SIM,N=NAO)D7T “SP$ 
300 IF P$# = “S” THEN M = M + 45 RETURN 
340 IF P@® = “N” THEN RETURN 

270 GOTO 340 

JRUN 


CRIACAO DE VETORES DE FORMA 
VETOR TEMOVIMENTO: C/B/E/D7 
DESENHO ¢(S=SIM,N=NAO)? N 
VETOR 25 MOVIMENTO: C/B/E/D? 
DESENHO ¢S=SIM,N=NAOQ)? N 
VETOR SIMOVIMENTO: C/B/E/D? 
DESENHO ¢(S=SIM,N=NAQ)? § 
VETOR 4IMOUIMENTO: C/B/E/D? 
DESENHO (S=SIM,N=NAQ)? S$ 
VETOR SIMOVIMENTO: C/B/E/D? 
DEGENHG ¢€S=SIM,N=NAO)? N 
VETOR GIMOUIMENTOS (C/B/E/D? 
DESENHO (S2SIM,N=NAO)? § 
VETOR 7EMOVIMENTO: C/B/E/D7 
DESENHO (S=SIM,N=NAO)? S 
VETOR S2&MOVIMENTO!: (/B/E/D? 
DESENHO (S=SIM,N=NGO)? § 
VETOR SEMOVIMENTO: C/B/E/D? 


S$ 
B 
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DESENHO ¢(S=SIM,N=NAQ)? N 
VETOR TOIMOVIMENTO!: C/B/E/D? 
DESENHO (S=SIM,N=NAO)? S 
VETOR TTSMOVIMENTO! C/B/E/D? 
DESENHO (S=GSGIMsN=NAOQ)? S 
VETOR T2°MOVIMENTO!: C/B/E/D? 
DESENHO (S=SIM,N=NAQ)? § 
VETOR T3°MOVIMENTO!: C/B/E/D? 
DESENHO ¢€S=SIM,N=NAQ)? N 
VETOR T4°MOVIMENTO® C/B/E/D? 
DESENHO (S=SIM,N=NAOQ)? S 
VETOR TS8MOVIMENTO:® C/B/E/D? 
DESENHO (S=SIM,N=NAQ)? § 
VETOR 162MOVIMENTO! C/B/E/D? 
DESENHO ¢€S$=SIM,N=NAQ)? S 
VETOR T75MOVIMENTO® C/B/E/D? 
DESENHO ¢S=SIM,»N=NAO)? N 
VETOR T82MOVIMENTO!: C/B/E/D? 
DESENHO (S=SIM,sN=NAO)? § 
VETOR T92MOVIMENTO: C/B/E/D? 


VETOR PARA MODIFICAR (O=FIM): 


BTTE VE TOR 
i 12 
"1 oF 
2 aQ 
3 &4 
“ =D 
2 13 
& 36 
z TE 
8 7 
9 QO 
J 


ENTRANDO A TABELA DE FORMAS 


F 


0 
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Antes de rodar as formas digitadas, deve-se colocd-las na memoria do computador. Para isso é 
necessario determinar em que drea de memoria a tabela vai ficar. A maneira mais facil de criar 
essa area reservada 6 colocar o HIMEM: em um valor imediatamente abaixo do DOS ou antes 
da pagina grafica de alta resolucao usada. Deve-se operar o HIMEM: antes de executar qualquer 
declarac¢ao em Applesoft que opere com cordées. Em se usando Applesoft com disco, sao neces- 
sarios no minimo 36K de memoria (embora 48K seja melhor) para permitir o interpretador 
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Applesoft e o DOS. Os enderecos 115 e 116 ($73 e $74) contém o Ultimo HIMEM: determinado 
para o Applesoft, com o byte menor armazenado antes. Para calcular o novo valor do HIMEM: 
que libere area para a tabela de formas, use a seguinte declaracao: 
PRINT PEEKCI16) *& 236 * PEERCTIS) = X 

Esta declaracdo calcula o valor de HIMEM: a ser usado baseado no pardmetro X, que é o 
comprimento da tabela de forma, incluindo diretdrio. Usando esta declaracdo, troque X pelo 
comprimento da tabela. Cologue HIMEM: no valor calculado antes de colocar a tabela na memo- 
ria. Isso a protegera de ser suja pelo Applesoft. 

Como alternativa, pode-se colocar a tabela na memoria entre as posicdes 768 e 975 ($300 
e $3CF) inclusive. Cuidado para nado haver conflito com qualquer sub-rotina em linguagem de 
maquina colocada la anteriormente. 

Pode-se usar a declaracdo POKE para colocar a tabela de forma na memoria. Por exemplo, 


a seguinte série de declaracdes POKE coloca a tabela de formas do nosso quadrado na memoria 
iniciando na posicao 768: 


IPOKE 748,01 
JPOKE 769,00 
JPOKE 770,04 
JPOKE 7717700 
IPOKE 772237 
IPOKE 773950 
JPOKE 774,00 


Pode-se também entrar a tabela através do Monitor. Use a declaracgao CALL-151 para pular 
ao Monitor. Entre entdo o endereco ‘‘hexadecimal’’ da memoria onde a tabela iniciara, seguido por 
dois pontos, digite o primeiro byte do diretoério da tabela, um espaco em branco, o byte seguinte 
do diretdrio, outro espaco etc. Acione RETURN. Digite entao outra vez dois pontos seguido pelos 
bytes em hexadecimal da primeira forma da tabela (separando os bytes com espacos), e acione 
RETURN. Repita este Ultimo passo para cada forma do diretoério. Pode-se rever o trabalho digi- 
tando o endere¢o inicial da memoria, dois pontos, e o endereco final da tabela, acionando RETURN. 


Para maiores informacdes de como usar o Monitor, veja o Capitulo 7. A tabela para o quadrado 
é digitada assim: 


ICALL ~-13514 


% Entrada do Monitor 

*460002:01 00 04 00 Entrando o diretério da tabela de formas 
*52C BSE OO Entrando a forma 1 

#4000.6004 Verificando o novo contetido da memoria 
&4000~- 071 00 04 00 2C SE OD 

* 


A tabela de formas agora esta na memoria. A primeira entrada comeca com o endereco 
inicial da tabela (neste caso $6000). Os dois pontos dizem ao Monitor para colocar uma série de 
digitos hexadecimais na memoria. Imediatamente apds os dois pontos vem o diretorio da tabela: 
01 (o nimero de formas da tabela), 00 (0 segundo byte nao é utilizado), 04 e 00 (o deslocamento 
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da forma 1 a partir do infcio do diretério — o byte de menor ordem vem primeiro). A linha seguin- 
te inicia com dois pontos; nado é necessario nenhum endereco inicial se ele foi indicado na entrada 
anterior. O Monitor vai colocar a proxima série de digitos hexadecimais imediatamente seguinte 
a primeira série entrada. 

A ultima linha diz ao Monitor para mostrar os enderecos de memoria de $6000 a $6006. 
O formato deste comando é: endereco inicial, seguido por dois pontos (que diz ao Monitor para 
mostrar memoria), seguido pelo endereco final. Verifique cuidadosamente o que foi entrado cada 
vez que usar o Monitor para digitar tabelas de formas. 


Guardando a Tabela de Formas em Fita ou Disco 


Apos se gastar um bom tempo montando tabelas de forma, certamente é uma boa idéia guardar 
esse trabalho em algum meio magnético ao invés de perdé-lo quando se desligar o Apple ||. Pode-se 
usar Cassette ou disco para tal fim; o disco é preferivel porque guarda e recupera os dados muito 
mais rapidamente que a fita. 

O Applesoft tem um comando chamado SHLOAD que opera exclusivamente com fitas. 
Antes de jogar a tabela de formas na fita, deve-se calcular seu comprimento (em bytes, hexade- 
cimal). Continuando com o nosso exemplo do quadrado, conte o nimero de bytes usados 
na tabela; o comprimento total é 7 bytes. Usando o Monitor, entre com o comprimento da tabela, 
iniciando no endereco 0: 


e007 GO 


Como sempre acontece com quantidades de dois bytes entradas pelo Monitor, o byte de me- 
nor ordem vem primeiro. Rebobine a fita até o inicio. Ligue no modo RECORD. O Monitor sera 
usado para gravar 0 comprimento da tabela e ela mesma. Isso é feito em duas operacdées de gra- 
vacao, que podem ser comandadas na mesma linha: 


e.1NW S000.é6006W 


O primeiro comando de escrita coloca o comprimento da tabela (colocado nos enderecos 0 e 1 
da meméria) na fita. A segunda operacdo coloca os sete bytes da tabela do endereco $6000 até 
$6006, na fita. As duas operacdes em conjunto demoram cerca de 20 segundos. O falante emite 
sons por duas vezes durante o processo de gravacdo. Apds o segundo bip, pare o gravador. A 
tabela entado estara gravada na fita para uso posterior. Use o tamanho, endereco inicial e endereco 
final da sua tabela ao invés destes do exemplo. 

Ao usar o disco para guardar tabelas, use o Applesoft com o DOS (a partir do Monitor, com 
3DOG). O comando usado é BSAVE. E necessdrio conhecer o endereco inicial e o comprimento 
da tabela a ser guardada, no nosso exemplo iniciando em $6000, o comando DOS. 


BSAVE QUADR ADO, Ag€SNO0, 7 


Cria um arquivo em disco chamado QUADRADO com tipo B de binario. A tabela entdo fica 
gravada em disco, pronta para ser usada mais tarde. Use em cada caso particular o nome, endereco 
inicial e comprimento apropriados no lugar destes do exemplo. 
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Carregando Tabelas de Forma de Fita ou do Disco 


Apés guardar Tabelas de forma em fita, o Applesoft pode ler de volta para a memoria. Primeiro, 
volte a fita até o inicio. Depois digite: 


SHLOAD 


Acione o botao PLAY do gravador. O alto-falante gera b/ps por duas vezes e entado devolve o 
controle do computador para o teclado. Se existir algum problema na fita, pode aparecer a mensa- 
gem de erro ERR na tela. Nesse caso tente ler a fita novamente, ou, se o erro persistir, verifique o 
ajuste do volume, como foi descrito no Capitulo 2. O SHLOAD coloca automaticamente o 
HIMEM: no seu valor corrente menos o comprimento da tabela lida em bytes. Confira se o valor 
HIMEM: foi mesmo acertado. 

Se a tabela foi gravada em disquette, acerte o HIMEM: antes de tentar lé-la para a memoria. 
O comando seguinte lé a tabela do quadrado: 


BLOAD GUADRADO 


O DOS se lembra o endereco a partir de onde foi gravado ($6000 no nosso exemplo) e colo- 
cara a tabela de volta automaticamente. Se for desejado ler para outro endereco, por exemplo 
$3000, digite: 


BLOAD QUADRADO, AGSOD00 


De novo, use 0 nome e o endereco de sua tabela no lugar destes, do exemplo. 

Apos carregar a tabela com o BLOAD, sera necessdrio colocar o endereco nas posi¢des 232 
e 233 ($E8 e $E9). O Applesoft usa essas posicdes para apontar a tabela de formas na memoria 
(o SHLOAD acerta estes enderecos automaticamente). Entre no Monitor e coloque o endereco 
($6000 no exemplo): 


ES2O0 6&0 
Alternativamente, pode-se usar a declarag¢do POKE para colocar o endereco inicial da tabela 


nas posicdes 232 e 233. Lembre-se que com o POKE deve-se colocar enderecos em decimal. 
Agora estamos prontos para usar as tabelas de forma nos programas em Applesoft. 


COMANDOS DE DESENHAR AS FORMAS 


O Applesoft tem quatro declaracdes para desenhar, apagar e mudar a orientacdo das formas: 


DRAW, que desenha a forma na tela do Apple II. 
XDRAW, que apaga a forma. 

ROT, que roda a forma em torno de eixos Xe Y. 
SCALE, que altera o tamanho da forma desenhada. 


Os comandos de manipulacdo de formas usam a pagina grafica de alta resolucdo (usando 
HGR e HGR2) e acor (usando COLOR), correntes. 
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O Comando SCALE 


Como declaracdo em modo imediato ou programado, pode-se sempre usar o SCALE antes de dese- 
nhar uma forma pela primeira vez num programa 


SCALE = 4 


manda manter a escala de um ponto para cada vetor de desenho. Se SCALE=5, o Apple I! desenha 
5 pontos para cada vetor de desenho. Pode-se comandar o SCALE até 255 (255 pontos para cada 
vetor). A maxima escala que se pode determinar 6 SCALE=O que coloca 256 pontos para cada 
vetor de desenho. 


O Comando DRAW 


O DRAW desenha a forma (numerada de 1 a 255) a partir da tabela de formas, na Ultima cor 
determinada, na escala e valor de rotacdo correntes. Esta declaracado 


RAW TY AT 40.96 


coloca a primeira definicao de forma iniciando na coluna 141 e linha 97 na pagina de alta reso- 
lug¢ao. O desenho comeg¢a nas coordenadas dadas nesta declaracdo. Uma segunda opcdo da decla- 
racao DRAW usa a posicao inicial implicita. 


RAM 4 


Esta declaracdo desenha a décima-primeira forma da tabela no Ultimo ponto usado pela de- 
claragdo DRAW ou HPLOT anterior mais recente. No caso das coordenadas nao terem sido refe- 
renciadas anteriormente, é adotado o ponto 0,0. 

IMPORTANTE: O Applesoft assume que a tabela de forma esté colocada corretamente na 
memoria. Antes de executar uma declaragdo DRAW, certifique-se que a forma esteja realmente 14 
e os enderecos 232 e 233 ($E8 e $E9) apontem o inicio da tabela. Se for indicado um numero de 
forma maior que o numero de formas existentes na tabela, ou se a declaracdo DRAW usar linhas 
ou colunas nao validas, o desenho nao é executado; em seu lugar a mensagem de erro ?ILLEGAL 
QUANTITY ERROR é apresentada na tela. 


O Comando XDRAW 


Esta declaragao permite zerar uma forma sem limpar formas graficas anteriores. Aqui esta um 
exemplo: 


XDRAW 8 AT 90,94 


s 


Esta declaracao é sintaticamente idéntica ao DRAW; as coordenadas podem ser explicitas 
como mostrado acima ou implicitas como mostrado na Ultima declaracdo DRAW exemplificada. O 
XDR'AW verifica a cor da coordenada desenhada e desenha a forma numa cor ‘’complementar”’ 
aquela encontrada. No exemplo acima, o XDRAW ocorre na linha 91 e coluna 97 na tela. A Ta- 
bela 6.6 lista os complementos das cores de alta resolucdao. 

Se as coordenadas, rotacdo e escala forem as mesmas da forma presente na tela, XDRAW 
limpa a forma, deixando todo o resto do grafico intacto. 
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TABELA 6.6. Cores de Desenhos. 


Preto 





Branco 









Branco 
Violeta 
Laranja 
Verde 
Azul 


Preto 
Verde 
Azul 
Violeta 
Laranja 














O Comando ROT 


O comando ROT roda a forma em relacao ao centro da tela (nos eixos X e Y). A declaracdo 
ROT=16 


coloca o angulo de rotacdo da forma em 90 graus no sentido hordario. O valor da ROT varia de 0 a 
255, apesar de haver apenas 64 possibilidades de rotacdo, de 0 a 63. A Figura 6.4 mostra as mudan- 
¢as nas orientacoes dos eixos a partir dos valores de ROT. 

Quando o valor do SCALE é colocado em 1, o ROT apenas roda a forma em incrementos de 
90 graus, o que significa que apenas quatro rotacdes validas podem ser obtidas:0=0 grau, 16=90 
graus, 32=180 graus e 48=270 graus. O Applesoft arredonda o valor de rotacdo dado ao préximo 





FIGURA 6.4. Rotacado da Forma. 
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menor valor de incremento do ROT. Todas as 64 possibilidades de rotacdo ficam disponiveis ao 
se usar SCALE=5 ou maior. 


Usando Formas em um Programa 


O programa listado abaixo serve como um bom exemplo de aplicagado de formas e como elas se 
aplicam a programas: 


4 LOMEM: 24400 

20 HGR? 

St} REM [INDICA ENDERECO DA FORMA 

60 POKE 232,0 

70 POKE 233,96 

75 REM USA TODAS AS CORES AL TERNADAS 
746 FOR I = 4 TO 7 

79 REM INCREMENTA © FATOR DE koTACAO 
80 FOR H = 4 TO BO 

82 HCOLOR = H 

oO ROT = I 

92 IF 1450 THEN SCALE#1 

105 DRAW 1 AT 140,96 

406 ROT = I + 32 

440 DRAW 4 

430 NEXT I 

140 NEXT H 

450 GOTO 74 


Usar formas grdaficas de alta resolucdo é especialmente interessante em jogos. Pode-se montar 
uma biblioteca de formas sem ter que documenté-las como se faria usando declaragoes HPLOT. 
Elas diminuem em muito o consumo de memoria. SAo necessdarios poucos calculos para manipular 
o tamanho e a orientacdo dos objetos em alta resolucdo criados, e os célculos sao simples quando 
comparados com a série de declaracdes HPLOT necessdria para desenhar uma forma. Se existir 
ainda alguma dificuldade sobre as formas de alta resolucdo, tente monta-las por conta propria. 
Isso 6 um pouco complicado devido 4 quantidade de passos necessarios para fazer aparecer uma 
Unica forma grafica na tela. Usando o programa anterior que codifica as formas automaticamente, 
o trabalho fica facilitado. 


O SOM DO APPLE Il 


Apos a ultima secdo vista neste capitulo, pode ser um alivio ou um aborrecimento o estudo do 
sistema de alto-falante embutido no Apple II. Alivio porque a operacdao do alto-falante é real- 
mente bem simples. Aborrecimento porque nao se pode controlar esta parte com declara¢gdes em 
BASIC. Deve-se definir todos os sons que o Apple || emite em todos os detalhes. Essencialmente, 
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tudo o que se pode fazer na programacao do alto-falante é fazé-lo’ emitir um Unico click. Para 
emitir sons diversos com o alto-falante varia-se a frequéncia desses clicks, criando assim sons de 
diferentes tons. Esta se¢do mostra como operar o alto-falante, e inclui um programa que cria uma 
série de sons. 


OPERANDO O ALTO-FALANTE 


O Apple II usa a posicdo de meméria —16336, também conhecida como 49200 e $C030, como 
uma chave liga-desliga, a exemplo das chaves graficas vistas anteriormente neste capitulo. A qual- 
quer momento em que se acessar esta posicao, é emitido um click do falante do Apple II. Em 
BASIC, pode-se operar o falante usando a declaracdo 


A=ZPEEK C4920) 
ou 
A=PEEK C-16396) 


Usar um programa BASIC para comandar o falante (mostrado no exemplo acima) é simples, po- 
rém o falante so gera frequéncias baixas. Isso porque o BASIC é relativamente lento. Em Integer 
BASIC, a maior frequéncia possivel @ cerca de 256 Hz (ciclos por segundo), e em Applesoft, a 
maior frequéncia é 72 Hz. A Unica forma de gerar sons de frequéncia mais alta 6 usar uma sub- 
rotina em linguagem de maquina para operar o falante. 


7 REM DAR UM “CLICK” NO ALTO’ FALANTE 
410 A * PEER. €-16396) 
2Q GOTO 10 


A Sub-rotina em Linguagem de Maquina para Som 


Tanto o Applesoft quanto o Integer BASIC tem uma area de memoria entre 768 e 975 ($300 e 
$3CF) para sub-rotinas em linguagem de maquina e tabelas de formas sem necessidade de alterar 
as atribuigdes de LOMEM: (o DOS usa esta 4rea, eliminando todo o contetido anterior, quando 
carregado a partir do DOS master disquette em verses anteriores a 3.3). 

Mesmo se nao souber linguagem assembler e de maquina, incorpore a sub-rotina seguinte 
em programas escritos em Integer BASIC ou Applesoft, digitando uma série de nimeros hexade- 
cimais. Para colocar a sub-rotina na memoria, entre no Monitor com o comando CALL-151 ou 
acionando RESET (/mportante: com o DOS, certifique-se de té-lo carregado antes de entrar no 
Monitor). Entado, digite a sub-rotina em linguagem de maquina, como mostrado abaixo: 


YCALL =154 
%F G66G 


ISQ022LDY 301 


G302-— . AC 67 G2 LDY | #0304 O computador responde 
| LDA 301 com as linhas escuras 
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o305- AE O01 03 LOX #0304 
| LDA H4 


O20e- A? 04 LDA G14 
f JSR FCA 

O20A- 20 AG FG J5R $F OAS 
1! LDA CO3O 
U20D- Ale 
| TNX 


hag 
8 


CO LDA $0030 


0310- Ee TNX 
| SME 2) 


Osil- vO FD BE #0270 


| Gey 


Se es ae 
1 BNE 305 


Boi4= = = ba ce BNE $0305 
1 HEC 300 

O844—- FE oO 8. BEC 40300 
' BNE 302 


fal 


Sie DU EZ ENE $0302 


< 
RTS 


3 


D21E- SU) RTS 


Esta sub-rotina usa enderecos $300 e $301 para guardar dados; os enderecos $302 até $31B 
contém a rotina. Uma vez digitada a sub-rotina, verifique se esta correta, assim: 


ISP FE OG 
#3021. 


HN3202- Al 1 OS LDY $0201 
Nau AE O11 O2 Lx 80301 
O308- (ry 14 LDA HEM4 
DOA A 2eQO Ag FO AEE % FAB 
O3O0D-- AD 30 CO LDA SCS 
We to= Ee TNX 

Ost DO FD BNE, #0210 
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N313- 88 DEY 
OZ14- DO EF BNE #0305 
0316~ CE 90 93 DEC  #o200 
NS19- po EF BNE #0302 
OS1B- 40 RTS 
O21C- 30 20 70 JSk $7020 
O24F- 08 PHP 
O320- 48 cL 
O321- de CLO 
O322- 88 DEY 
n323- og PHP 
O324~ Aad an LDY  — 4#A0 
N3e6- 10 39 BPL = $0340 


*% < CTRL-B no BASIC aqui 


Tendo o DOS no Apple II, pode-se guardar esta sub-rotina em disco com o comando BSAVE: 
BSAVE SOM, A$ S0L2, Les 


Isso cria um arquivo bindrio chamado SOM, que pode ser lido mais tarde. Tendo cassette, grave 
a rotina com o seguinte comando no Monitor: 


#202. 376 W 


A sub-rotina é gravada na fita para uso futuro. 


A Interface do BASIC 


Precisaremos uma rotina em BASIC que fale com a sub-rotina em linguagem de maquina. Digite 
a seguinte listagem em Applesoft ou Integer BASIC: 


Se@Q00 REM OPERACAOQ DE AL TO-FALANTE 
3210 POKE 7667D 

seecQ POKE 769,F 

3230 CALL 770 

2e4Q RETURN 


Com esta rotina em operacdo conjunta com a rotina em linguagem de maquina, um programa 
BASIC pode gerar sons através de duas variaveis: F (para frequéncias) com variacdo entre 1 e 255, 
com 255 sendo o maior tom, e D (para duracao) também entre 1 e 255, com 255 sendo o maior 
intervalo de dura¢ao possivel. Como exemplo, digite o programa BASIC seguinte apds a sub-rotina 
anterior: 


1O FOR ff = 4 70 254 
eQ F = 4 

30 D = I 

40 GOSUB 3200 

0) NEXT I 

60 END 
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Ao rodar o programa, ouca a duracdo de cada nota. Nos finais de escala em baixa e alta frequéncia, 
Os sons sao menores que os obtidos em freqUéncias médias. Este problema é inevitavel porque a 
sub-rotina em linguagem de maquina usa instrucdes ao invés de tempo para trocar a freqUuéncia de 
cada nota. Desde que nao existe reldgio de tempo real no Apple II, este método é necessario. 
Gerando duracées maiores para notas muito altas ou baixas pode-se obter a equalizacao. 


Um Programa de Sons mais Elaborado 


O programa listado abaixo usa as rotinas de geracdo de som mostradas antes para criar uma série 
de sons que podem ser ouvidos, alterados e finalmente impressos para uso em outros programas em 
BASIC. Ao rodar o programa, aparece a mensagem (D)IGITA, (E)SCUTA, (I)/MPRIME? A pri- 
meira acao é para digitar tons; digite E e acione RETURN. 

Agora a mensagem TON 0: FREQUENCIA, DURACAO? aparece. Entre dois nimeros sepa- 
rados por virgula. O primeiro é a frequéncia e o segundo é a duracdo. Ambos os numeros devem 
estar entre 1 e 255. Ao acionar RETURN depois da digitacao da frequéncia e duracao do tom, o 
falante do Apple || emite o tom. Este processo se repete para uma série de tons (até 100). Apds 
o Ultimo tom entrado, digite 0 para tom e O para duracao para finalizar. 

Depois de digitar todos os tons, a escolha QUE NOTA DEVE ALTERAR? aparece. Se a 
intencao é trocar algum dos tons entrados, coloque o seu numero; caso contrario digite 0. 

A mensagem (D)IGITA, (E)SCUTA, (1)MPRIME? aparece de novo ao final das alteracoes; 
agora digite E e acione RETURN. O Apple I! repete toda a série de tons digitada. Ao final da 
ultima nota, a mensagem aparece de novo. Coloque | para mostrar ou imprimir as frequéncias e 
duracoes atribuidas a cada nota. 

O programa listado abaixo pode facilmente ser modificado para permitir guardar os valores 
dos tons em cassette ou disco. Outros programas podem reler os tons gravados e, usando sub- 
rotinas de geracdo de som, tocar musicas e simplesmente emitir sons aleatorios. 


10 REM PROGRAMA DE GERACAQ DE SONS 
1? REM ©O ARRANJO GUARDA OS TONS 

20 DIM AC100,2) 

2° REM LIMPA A TELA 


ou CALL =936 

4) INPUT “¢DoTGITA, CE OSCUTA, CTOMPRIME?T* 3? AS 
“QO IF At = “"E* THEN 7000 

40 IF AS = “1*" THEN 1200 


80 IF Ag’ < > “DY THEN 30 

81 REM ENTRANDG CADA TOM 

90 PRINT 

100 I = 6 

405 Moe I 

110 GBOSUR 3000 

119 REM FIM DA BIGITACAO? 

120 TF F = 0 AND BD = 0 THEN I = [ ~ 43 GOTO 200 
129 REM NAG» GBUIARDA NOME 

130 ACT-1) = Pr4ei.B) = 8 


228 


140) 
450 
200 
205 
as 
208 
210 
22t 


349 
ae ad 


7000 
{O10 
4020 
{O30 
1040 
4200 
1210 
4220 
1230 
4240 
4250 
od 
1260 
SQO00 
3010 
wat 
S020 
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T= i+ 4 

GOTO 105 

REM TROCA QUALQUER ITEM AQUI 
PRINT “QUE NOTA DEVE ALTERAR? (O-—“sts"93 
INPUT 

IF E = 0 THEN 30 

IF E ¢ 4 OR E > T THEN 205 
M = Et GOSUB 3000 
ACE;1) = FRACE,2) = Dt GOTO 205 

REM OUVIR NOTAS ENTRADAS 

FOR K = 0 TO I 

Fo= ACK+1)2D = ACK,2)2GOSUB 3200 

NEXT k 

GOTO 30 

REM IMPRIME AS NOTAS 

PRINT “NOTAH”, “FREQ”. “DURACAO’ 

FOR K = 4 TO 1 

PRINT KyACK, 1) ACK 22) 

NEXT kK 

PRINT 

PRINT “ACTONE RETURN PARA CONTINUAR’S INPUT 2$ 
GOTO 30 

PRINT “TOM “3M3 

INPUT “ ENTRE FREQUENCIA, DURACAO">F,D 

IF F = 9 AND D = 0 THEN RETURN 

IF (F <¢ 0 OR F > 255) OR (D ¢ 4 OR D > 255) 


THEN 3070 


3030 
304) 
32a QO 
2210 
32 2Q 
3a 


el) 


GOSUB 2200 

RE TURN 

REM CONTROLE DOO ALTO FALANTE 
POKE 748,D 

POKE 749 7F 

CALL #70 

RE TL Ee N 
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Monitor de Linguagem de Maquina 


Existe um programa de controle residente no Apple I! em memoria ROM (ready-only memory) 
chamado Monitor. Este capitulo descreve suas caracteristicas e usos, mostrando como opera-lo 
em conjunto com os seus programas dedicados em BASIC. O Monitor é escrito em linguagem de 
maquina; serve como elo entre o BASIC (e as outras linguagens suportadas pelo Apple II) e as 
varias fun¢cdes de baixo nivel executadas pela maquina, como imprimir um caractere, desenhar uma 
linha e assim por diante. 

Pode-se também usar o Monitor via comandos do teclado. Um dos usos é fazer a tabela de 
formas (descrita no Capitulo 6), para examinar memoria e isolar problemas de hardware, ou pro- 
gramar em assembler. A maior parte das vezes nado é necessario emprega-lo, porém ele tem algumas 
funcdes que podem ser Uteis. 

Apos descrever o Monitor e suas facilidades, este capitulo mostra como usar o Mini-Assem- 
bler. Nado nos propomos aqui a ensinar a programar em linguagem assembler; o Apéndice K de cada 
livro ensina assembler. Sera mostrado como integrar seu programa em assembler com um programa 
BASIC, e como usar o Mini-Assembler para escrever, testar e depurar. 


ACESSANDO O MONITOR 


Existem duas verses do Monitor: a versdo padrdo e a versdo Autostart. Se seu Apple || tem um 
Monitor padrao, simplesmente ligando a maquina o controle estara no Monitor. Nesta situacao, 
havera a tela cheia de caracteres aleatérios, com um asterisco ( * ) no canto direito em baixo da 
tela e o cursor piscando a direita do asterisco. Este asterisco 6 o de entrada no Monitor. 

Se o Apple I! tem o Monitor Autostart (tanto como facilidade adicional ou como equipa- 
mento padrao no Apple I! Plus), sera necessario usar ou Integer BASIC ou Applesoft para acessar 
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oO monitor. Quando aparecer o caractere de entrada do BASIC (ou > para o Integer BASIC ou | 
para o Applesoft), digite o sequinte comando: 


CALL. <151 


Esta declaracdo é realmente uma chamada de sub-rotina para o endereco FF69, mas o 
BASIC nao reconhece nimeros hexadecimais, de forma que se deve usar o decimal equivalente 
ao FF69 neste comando. Uma vez digitada esta declaracao, aparece o asterisco, seguido do cursor. 
Neste ponto ja se esta no Monitor. 


DEIXANDO O MONITOR 


Existem poucas formas de se deixar o Monitor e voltar ao BASIC; elas dependem fortemente do 
que se deseja fazer apos deixa-lo. Para preservar as declaracdes de programa e as varidveis usadas no 
programa BASIC, deixe o Monitor acionando CTRL-C, e depois RETURN. Apos fazer isso, volta-se 
ao BASIC. Neste ponto se pode imprimir o valor das variaveis e listar o programa (se algum deles 
estiver na memoria nesse momento). 

Para exemplificar, vamos supor que se colocou um valor numa posi¢ado de memoria via 
declarac¢do POKE e se deseja verificar o POKE. Claramente, se poderia usar PEEK para esse pro- 
pdsito, porém o Monitor permite acesso mais facil 4 memoria do Apple || do que PEEK e POKE. 
O exemplo em Integer BASIC dado abaixo mostra como usar o CTRL-C preservando o programa 
BASIC e as varidveis ao deixar o Monitor: 


>10 A=123 
19 REM MOVE CURSOR PARA 134. COLUNA 
>20 POKE 34,12 
+30 PRINT A 
>40 END 
>RUN 
123 
POALL. "4 
% < Acione CTRL-C e depois RETURN 


>PRINT A 
123 
*LIST 
10 AB123 
19 REM MOVE CURSOR PARA 13A.COLUNA 
2Q POKE 234,12 
20 PRINT A 
40 END 
y 


Querendo deixar o Monitor e limpar o programa BASIC corrente e as variaveis guardadas na 
memoria, acione CTRL-B e depois RETURN. Assim volta-se ao BASIC, porém qualquer declaracao 
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de programa ou variadvel presente na memoria serao zerados. Tente o exemplo acima, substituindo 
CTRL-C por CTRL-B. Na volta ao BASIC verifique que nao haja mais varidveis nem programa 
algum. 

O CTRL-C opera corretamente com o Integer BASIC e o Applesoft em firmware. Nao fun- 
ciona com Applesoft em disco ou cassette. 

Com o Applesoft em disco ou cassette deve-se usar o CTRL-B para deixar o Monitor. Neste 
caso havera o retorno para o Integer BASIC e as varidveis e programas em Applesoft serdo perdi- 
dos. Existe uma forma de voltar ao Applesoft com programas e variaveis intactos. 

Para voltar ao Applesoft em disco do Monitor, digite este comando: 


#3DO0G 
Para voltar ao Applesoft em cassette do Monitor, digite este comando: 
#1) G 


3DQOG e 0G sao dois comandos do Monitor (semelhantes ao GOTO do BASIC). Mais tarde 
serao vistos outros detalhes. 
IMPORTANTE: Use 0 comando 0G apenas no Applesoft em cassette. 


FUNCOES DO MONITOR 


O Monitor executa um nuimero limitado de tarefas, mas cada uma delas é relativamente poderosa, 
considerando o tamanho reduzido do programa. Pode-se examinar posi¢des de memoria ou os 
registradores internos do microprocessador, listar conteUdos de uma area de memoria na tela, ou 
jogar para outro dispositivo de safda, como a impressora, e ainda trocar o contetiido da memoria 
ou dos registradores. Outras funcdes incluem mover blocos de dados de um endereco para outro e 
comparar dois blocos de posicdes de memoria. Ainda existem algumas outras funcdes que apa- 
recerdo neste capitulo. 


EXAMINANDO A MEMORIA 


Existem trés métodos no Monitor usados para analise do conteido da memoria: modos de endere- 
¢camento simples, palavra ou bloco. Um endereco simples referencia uma posic¢do de memoria de 
um byte. Uma palavra é um segmento de memoria de oito bytes, comecando com um endereco 
divisivel por oito. Um bloco é a forma mais conveniente de ver uma drea de memoria, iniciando 
com um endereco e terminando com outro mais alto. 


Examinando Enderecos Simples 


Ao se ver o Caractere do Monitor e desejando ver uma Unica posi¢ao de memoria, digite o endereco 
hexadecimal dessa posi¢ao seguido pela tecla RETURN, como no exemplo abaixo: 


BFF ES 
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O Monitor responde com a apresentacao do contetido daquela posicao: 
BEEF 69 AP 


Quando se digita um endereco, o Monitor o retém para uso posterior, como um apontador. 
Assim, ao se digitar FF69 (ou outro endereco hexadecimal qualquer), o Monitor se lembrara 
daquela posi¢do, usando-a como referéncia para exames posteriores de memoria, até que ele seja 
mudado. Para trocar o apontador usado pelo Monitor, simplesmente digite um novo endereco. 
Por exemplo, digite: 


* S00F 


e o Monitor pde esse novo endereco no apontador além de mostrar 0 contetido do endereco 300F. 


Examinando Palavras de Memoria 


Suponhames que foi examinado o endereco simples FF69 do exemplo acima, e agora se deseja 
ver os conteddos dos proximos enderecos superiores da memoria. O Monitor vai continuar exami- 
nando memé6ria se for digitado RETURN, como mostrado abaixo: 


HEF GD 
FF E9~ Ag 


% < Acione RETURN 


FF7Q- 20 C7 FF 20 A? FF 94 


ws 
as 


* < Acione RETURN novamente 


A primeira vez que foi acionada a tecla RETURN no exemplo, foram mostrados seis bytes na 
tela. Sdo eles os contetdos das posicdes de FF6A até FF6F. A segunda vez que se acionou RETURN 
toda a palavra de oito bytes foi mostrada, com o endereco de memoria inicial da frente (FF70) 
para lembrar qual foi a posicdo inicial. Toda a palavra inicia numa posi¢ao de memoria divisivel por 
oito, daf porque o endereco inicial ndo apareceu na primeira vez em que RETURN foi acionada. 
O primeiro RETURN simplesmente terminou o bloco iniciado anteriormente no exame de uma 
Unica posicdo. 


Examinando Blocos de Meméria 


Pode-se examinar uma area maior de memoria (normalmente mais de oito bytes) em modo blocado. 
Digite o endereco inicial em hexadecimal, seguido por um ponto, e finalmente o endereco final 


*F OOO ef SSF 


O Monitor responde com o contetido das posicdes de memoria do bloco: 
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também em hexadecimal. Por exemplo: 


233 


FSO00~- 3A 24 6E 6F DA 74 PR 12 
FRO8- 21 00 98 FE De FF 44 98 
FAa10- 83 5F DD 21 74 83 4F 4A 
FAIS~ az OF 55 FO OF BE 42 12 
Fa2o- C8 20 34 4F 4b 3C 5? 2A 
FE28- 48 00 20 FB 68 CS 2D 27 
Fa80~ FS 47 1&4 AC 43 22 CB 4F 
Fa38- 84 2D AO BB IE 3E 55 00 


O endereco inicial deve ser menor ou igual ao endereco final para que se veja mais de um 
endereco. Se o endereco final for menor que o inicial, aparecera apenas o contetdo do endereco 
inicial. 

Pode-se especificar uma area de enderecos que exceda o tamanho da tela do Apple II. Neste 
Caso os dados vao saindo tela acima para dar lugar aos outros que vao aparecendo. Nao se pode 
cancelar este comando sem acionar RESET. Se o Apple II contiver o Monitor Autostart, pode-se 
parar temporariamente o processo acionando CTRL-S. Isso faz com que pare a saida pela tela, 
mas nao cancela a safda para outro dispositivo qualquer, como a impressora, dando a chance de 
ler a tela. Acione a barra de espaco para continuar o processo. 

O método blocado de examinar memoria é conhecido como dump. Quando ele termina, o 
apontador que mantém o proximo endereco a ser examinado é atualizado de forma a apontar o 
proximo byte depois do endereco final examinado do bloco. 

Uma forma mais compacta deste comando usa o apontador como endereco inicial do bloco. 
Digita-se o ponto seguido pelo endereco final do bloco. Por exemplo, se foi visto o endereco F800 
até F83F, como no exemplo acima, pode-se continuar examinando um bloco iniciando em F840 e 
finalizando em F880 digitando-se: 


que resulta na seguinte saida: 


it 
: Ey 


Fe40- 20 28 Fa BS 10 FA 483 
Fa@8- 3E 09 83 FE 54 1a oF 


FES0~- 2h 4F DD SB 6G 71 OG 4A 


mn 
ovat 
—_, 

- 


f 
FeSd- O08 O00 12 34 4D N0 30 2A 
Ct: 


¢} 
860~- 66 QO8 10 3B CA TA 20 3D 
reuégo~ 3h EE CF O48 DOO 34 B77 O00 
FE70- 34 AD 26 OC B3 TE FS 4F 
FS783- TA 00 32 4D EC FA DE O71 


OF 
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EXAMINANDO OS REGISTRADORES DO MICROPROCESSADOR 


As vezes é necessério examinar o contetido dos registradores internos do microprocessador. Isso 
é feito digitando-se CTRL-E, seguido pela tecla RETURN. O resultado se parece com: 


A=CD X=B1 Y=C3 P=BS S$=FO 


Os valores mostrados séo aqueles guardados no Acumulador (A), Registrador de Indice X 
(X), Registrador de Indice Y (Y), Registrador de Status do Processador (P) e Apontador de Pilha 
(S). Os valores 4 direita de cada sinal de igual so os Ultimos valores dos registradores. Entretanto, 
eles nao sdo afetados pelo funcionamento do Monitor. Em outras palavras, o contetido dos regis- 
tradores sdo salvos pelo Monitor e ficam intactos até que se execute um programa em assembler 
ou BASIC. 


ALTERANDO MEMORIA 


Alterar memoria é mais completo que simplesmente examina-la. Deve-se especificar qual o ende- 
reco a ser alterado bem como fornecer o novo dado que ira para o endereco. Pode-se alterar um 
endereco por vez (um byte por vez), ou pode-se modificar uma série de posicdes de memoria 
consecutivas, entrando novos dados para varias posi¢des de memoria consecutivas num Unico 
comando. 


Alterando Enderecos Simples 


O primeiro passo para trocar um endereco simples é indicar o apontador de endereco, que é o mes- 
mo usado para examinar memoria. Devido aos dois comandos terem o mesmo apontador, indica-se 
O endereco no apontador da mesma forma que no exame. Digite em hexadecimal o endereco a ser 
alterado, e acione RETURN. Por exemplo 


*¥1200 


coloca o apontador com 1200 hexadecimal. 
O Monitor responde com o contetido da posicao de memoria: 


T200= 73 


Veja que esta entrada produziu a mesma resposta que o comando de examinar enderecos 
simples. A resposta mostra que o endereco apontado é 1200, e também mostra o contetido ante- 
rior deste endereco (neste caso, 73). 

O passo seguinte é colocar um novo valor neste endereco. Para trocar, primeiro digite dois 
pontos (: ) seguido por um nGmero hexadecimal de dois digitos que ira ocupar aquele endereco. 
Por exemplo: 


SOF 
Os dois pontos (: ) indicam um comando de alteracao para o Monitor. O 5F indica o novo 
dado a ser colocado na posicado 1200. Pode-se alterar a memoria usando uma linha de comando ao 
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invés de duas, como mostrado abaixo: 
#72002 SF 


Esta linha de comando tem o mesmo efeito na troca do endereco 1200 que as duas linhas 
separadas mostradas acima. O apontador de endereco é atualizado para 1200, e o Monitor coloca 
5F naquele endereco. O apontador de endereco vai para a posi¢ao de memoria superior seguinte. 
Se for desejado trocar o endereco 1201 para 7F, por exemplo, digite: 


*o7F 


e o Monitor automaticamente atualiza o contetido de 1201 para 7F. Aqui também o apontador é 
incrementado de 1 e se pode entdo alterar o endereco 1202 para algum valor qualquer, conti- 
nuando o processo de alteragdo de memoria sem especificar o endereco. 


Alterando mais Meméoria 


O Monitor permite alterar mais de uma posicao de memoria por vez, colocando os enderecos que 
vao sendo alterados em seqiéncia na memoria (por exemplo, enderecos de 1200 até 1207 inclu- 
sive). Este comando inicia da mesma forma que o método de alterar posicdes simples de memoria. 
Primeiro acerta-se o apontador, se necessdrio. A seguir, usa-se dois pontos para indicar ao Monitor 
que este 6 um comando de alterar memoria. Finalmente, digita-se os dados que se deseja em cada 
posicao sucessiva, separando cada um deles com um espaco. 

Por exemplo, para colocar as quantidades de 00 a 07 nos enderecos de 1200 a 1207, digite: 


*¥T200°00 O01 02 03 04 O03 06 7 


Pode-se na verdade alterar mais de oito enderecos. Colocando-se 0 apontador no inicio deste 
comando, poder-se-ia alterar até 83 valores em uma Unica linha. Sem indicar o apontador, pode-se 
colocar até 84 valores. Em ambos os casos, a linha de comando pularia na tela ocupando varias de 
suas linhas. Isso nao é pratico porque quando uma linha de comando pula na tela, torna a verifi- 
cacao muito dificil. Além disso, a Unica forma de corrigir erros é dar backspaces até eles, corrigi- 
los, redigitando o resto da linha. Em caso de se colocar muitos dados numa linha de comando, 
isso fica mais dificil. 


Verificando a Alteragaéo da Memoria 


E uma boa prdatica verificar as alteragdes da memoria se o produto final (ou uma tabela grafica 
ou uma série de instrugdes em linguagem de maquina) deve ser preciso. Para isso deve-se usar 
uma das trés formas de examinar o conteudo da memoria vistos antes neste capitulo. Para iniciar 
a verificac¢ao do que foi digitado, deve-se colocar o endere¢o inicial na primeira posi¢ao onde foi 
feita alteracao. 

Assumindo que foi colocado 00 até 07 nos enderecos de 1200 a 1207, coloque o apontador 
em 1200: 


#1200 


O Monitor responde com: 


#1200- O00 
%& 
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Pressionando RETURN pode-se ver os sete enderecos restantes que foram modificados: 


* < Acione RETURN 


O1 O02 03 04 05 06 07 
% 


Se foram alteradas muitas posicdes, continue pressionando RETURN até aparecer a Ultima 
alteracdo efetuada. 
Pode-se também usar o método de examinar bloco para esta drea: 


*1200.1207 
O Monitor responde com: 


1200~- O00 O1 D2 O03 04 OS 06 Q?7 


% 


Corrigindo Erros 


No caso de erros na digitagdo das alteragdes, pode-se corrigir cada um individualmente sem se 
redigitar todos os dados. A forma mais simples é anotar o endereco do dado errado e usar 0 méto- 
do de alteracao individual para corrigi-lo. 

Por exemplo, se foi cometido um erro na colocacdo de 00 até 07 no exemplo anterior, e o 
erro apareceu em 1204, digite: 


*¥1204:04 


para Corrigir o erro neste endereco. O passo seguinte é olhar de volta o endereco 1204 e qualquer 
outra alteracdo feita para certificar que agora tudo esta correto. Finalmente verifique todas as 
alteragGes para se assegurar que tudo agora esta correto. 


ALTERANDO OS REGISTRADORES DO MICROPROCESSADOR 


O processo de se alterar os registradores do microprocessador é um pouco diferente do de se alterar 
memoria, porque os registradores ndo tém endereco. Para alterar seus contetdos, primeiro deve-se 
examinda-los usando o comando CTRL-E. Imediatamente apds 0 comando de examinar o regis- 
trador, troca-se seu contetido digitando-se dois pontos (o que significa uma operacao de alteracado 
no Monitor), seguido por de um a cinco n&meros hexadecimais. Os nimeros sdo separados por 
espacos. 

O primeiro nGmero hexadecimal sera o novo valor do Acumulador, o segundo n&imero sera 
oO novo valor do Registrador de Indice X, o terceiro sera o novo valor do Registrador de Indice Y, 
© quarto sera o novo valor do Registrador de Status do Processador e o quinto sera o novo valor 
do Apontador de Stack. Deve-se colocar valores para todos os registradores até o Ultimo da série 
que se deseja trocar. Pode-se deixar intactos os valores dos registradores além dele. 

Como exemplo, suponhamos que se deseja alterar o Registrador de Indice Y deixando os 
demais intactos. Primeiro, examinemos os registradores com CTRL-E. 
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x: + Acione CTRL-E e RETURN 
A=CD X=B1 YaBB P=BSH S=rFgO 
x 


(Note que os contetidos dos registradores acima sdo apenas exemplos.) 

Para trocar o Registrador de Indice Y para o valor hexadecimal 8A, sem trocar os outros 
registradores, digite os valores existentes do Acumulador e do Registrador de Indice X, seguidos 
pelo novo valor do Registrador de Indice Y. 


* 1D ET BA 


Para alterar qualquer registrador que nado o Acumulador (A), deve-se redigitar o conteido 
de todos os registradores até e inclusive o que vai ser alterado. 

Deve-se acionar CTRL-E e RETURN para examinar os registradores, ou o Monitor entende 
que se deseja alterar enderecos de memoria. O exame dos registradores diz ao Monitor para sair 
do apontador de enderecos para indicar posig¢des de memoria e passar para alteragdo direta de 
registradores. 

Para ilustrar outra alteracdo de registrador, vamos verificar o Apontador de Stack (seu 
contetido segue o S quando se examina os registradores) para passar a ter o valor 4B. Primeiro, 
lembre-se de examinar os registradores: 


3% < Acione CTRL-E e RETURN 


ASP XS Ysepd Pega S=Fo 


Agora digite os valores correntes, em ordem, para todos os registradores, e depois o novo 
valor do ultimo: 


werPr CD 87 BA 4B 


Confira a digitagado com outro CTRL-E para examinar os registradores uma vez mais. 


GUARDANDO E LENDO MEMORIA COM OS PERIFERICOS DO APPLE II 


O Monitor permite que se use um gravador cassette para guardar o contetdo de um bloco de me- 
moria em fita magnética. Isso é Util quando se criam formas graficas de alta-resolucao (veja o 
Capitulo 6), ou quando se faz programas em linguagem assembler que se deseja guardar. Com o 
Sistema Operacional em Disco do Apple || (DOS), pode-se guardar areas de memoria de forma 
ainda mais facil e confidvel, no disco. Para guardar memoria em disco deve-se deixar o Monitor 


temporariamente, usando o DOS dentro do BASIC para gravar e ler memoria. 


Guardando a Memoria em Fita Magnética 


Para gravar em fita, use o comando de gravar fita do Monitor. Deve-se informar a ele os enderecos 
inicial e final da area a ser gravada. O comando inicia com o endere¢o inicial, sequido por um 
ponto, o endereco final e finalmente a letra W. 
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Por exemplo, 0 comando: 
#2200. 2F FF 


diz ao Monitor para gravar contetido de meméOria, iniciando no endereco hexadecimal 2000 e fina- 
lizando no endereco 2FFF, no gravador cassette. 

O comando de gravacdo de memoria nao verifica os dados que manda para a safda de cas- 
sette; ela também nao testa (nem poderia) a existéncia de fita dentro do gravador conectado ao 
Apple I!. Deve-se fazer todo o necessadrio para assegurar que a fita nao tenha qualquer falha ou 
que exista qualquer problema inerente ao uso de fita cassette. 

Quando der o comando para gravar em fita, ndo acione RETURN até colocar o gravador no 
modo RECORD e que a fita esteja visivel mente em movimento. Se o cassette usado estiver no 
inicio da fita, deixe-o correr pelo menor por cinco segundos antes de acionar RETURN, para per- 
mitir que passe a parte inicial nao magnética pela cabeca. 

Ao se acionar RETURN, 0 computador espera durante dez segundos antes de mandar dados. 
Isso. permite ao gravador cassette zerar qualquer informacao prévia (musica, voz ou dados) na 
fita. O computador manda um tom de referéncia para a safda durante este tempo. O Monitor usa 
este tom mais tarde como um sinal de sincronismo para o comando de leitura (visto na se¢do 
seguinte). 

Quando o comando de gravar memoria termina, o alto-falante do Apple || da um bip e o 
controle volta ao Monitor. 

O comando de gravar permite que se guarde em fita desde um byte até 64 kilobytes (65.536 
bytes). O Monitor manda dados através da safda para gravador na velocidade de 210 caracteres 
por segundo aproximadamente (considerando que 16.384 bytes sdo enviados em 77,5 segundos, 
apds o tom de referéncia). Depois de transmitir o Gltimo byte de dado, o Monitor manda um byte 
de verificagado ao gravador. O comando de leitura usa este byte para verificar a validade dos bytes 
na leitura. 


Leitura de Dados da Fita Magnética 


O comando de leitura da fita permite pegar de volta os dados gravados em cassette e joga-los de 
volta na meméria. Para executar este comando, digite o endereco inicial (a partir de onde os 
bytes da fita devem ser carregados na memoria), seguido imediatamente por um ponto, o ende- 
reco final (onde o UJtimo byte lido sera colocado), e por fim a letra R. 

Por exemplo, o comando 


#2000.20FFR 


diz para ler dados do cassette para a memoria, iniciando no endereco hexadecimal 2000 e termi- 
nando em 20FF. 

Diferentemente do comando de gravar, este for¢a o Monitor a esperar até que se acione a 
tecla PLAY do gravador cassette. O computador espera o tom do gravador cassette, e o Monitor 
bloqueia o computador até a chegada do sinal. Antes de se acionar o PLAY do gravador, posicione 
a fita onde o tom de referéncia comeca. Pode-se perceber a diferenca entre o tom gravado e o lido 
de forma auditiva. Remova o cabo do fone externo para ouvir a fita usando o alto-falante do 
gravador. O tom de referéncia 6 um zumbido de tom médio e constante. Jd os dados se parecem 
com rufdo aleatério ou estatico. 
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Ajuste o volume do gravador antes de dar o comando de leitura. O procedimento para este 
ajuste 6 o mostrado no Capitulo 2. 

O comando de leitura de memoria espera pela leitura de exatamente a mesma quantidade de 
memoria que foi gravada anteriormente. Se foram gravados 1024 bytes numa fita e se deseja ler 
apenas os primeiros 256 bytes, o Monitor vai transferir os dados mas provavelmente vird também 
uma mensagem de erro. O mesmo acontece no caso de se ler mais dados do que esta gravado na 
fita; ha uma forte possibilidade de aparecer uma mensagem de erro. 


Condigdes de Erro no Comando de Leitura para a Memoria 


O Monitor ouve o gravador cassette pelo menos durante 3,5 minutos antes de esperar dados de 
entrada. Isso permite ao Monitor ficar em fase com o tom de referéncia. Se a fita contém menos de 
3,5 segundos desse tom, o Monitor perde o inicio da transmissdo de dados do cassette, resultando 
em erro de verificacdo. Além disso, ndo se fica sabendo em que ponto o Monitor comecou a ler a 
fita, porque ele sempre fica tentando ler dados da fita para a memoria, dados validos ou nado. Neste 
caso ocorre uma mensagem de erro (um S/p no alto-falante sequido da mensagem ERR no video 
€ o retorno ao Monitor). Para corrigir o erro, volte a fita ao inicio. Acione PLAY com o fio de 
conexao entre o Apple I! e o gravador desconectado e meca o tempo de durac¢do do tom. Se for 
menos de 3,5 segundos até o inicio dos dados, serd necessdrio gravar os dados novamente. Isso em 
geral acontece quando se esquece de pular manualmente o inicio nado magnético da fita. 

A leitura de mais ou menos dados da fita para a memoria do que aquilo que foi originaria- 
mente gravado provavelmente causa uma mensagem de erro na tela do Apple II. O ultimo byte 
enviado da memoria para o gravador durante o processo de gravacdo é o byte conhecido como 
checksum, um byte obtido pela somatéria de todos os bytes gravados. Logicamente, seu valor 
depende de quantos dados e do valor de cada um deles. Quando na leitura o que é lido nao coin- 
cide com o original, o Monitor ndo pode detectar qual byte lido é o checksum. Ele assume que o 
Ultimo byte que consegue ler seja o checksum. Assume também que o Ultimo byte que |lé do 
cassette para a memoria (determinado pelo endereco final no comando de leitura) sera seguido 
pelo checksum. Ele executa seu prdéprio calculo do checksum com os dados entrados na opera¢do 
de leitura e 0 compara com o que é lido do cassette. Se os dois bytes ndo coincidem, uma mensa- 
gem de erro é mostrada. E pouco provavel, mas possivel, que os dois bytes sejam iguais, por pura 
coincidéncia. Como regra geral, deve-se ler a mesma quantidade de memoria que foi gravada para 
permitir ao Monitor executar totalmente o controle através do checksum. Mais tarde, neste capi- 
tulo sera mostrado como verificar uma operacao de leitura de memoria através do Monitor. 


Guardando Meméria em Disco 


Com o Sistema Operacional em Disco do Apple ||, guardar contetido de memoria é muito mais 
facil e confiavel que em fita cassette. As regras para isso sdo um pouco diferentes porque se usa 
BASIC ao invés do Monitor para executar esta funcado. Este 6 um comando de nivel superior ao de 
manuseio de cassette inclufdo no Monitor, e por isso deve ser usado sempre que possivel. Antes de 
ler esta parte, 6 recomendavel que se tenha familiaridade com o DOS (no Capitulo 5). O DOS 
deve estar na memoria antes do inicio (veja Capitulo 2). 


Estando no Monitor, deve-se deixd-lo temporariamente, indo ao BASIC sob o DOS com os 
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comandos CTRL-C ou CTRL-B quando se tem o Monitor Autostart, ou o comando 3DOG no 
Monitor padrao. 
Aqui esta um exemplo do comando DOS para guardar contetdo de memoria em disco: 


BSAVE TABFORMA, AB3000, Leté,s Sé, Ot, V204 


Este comando faz criar um arquivo DOS em disco chamado TABFORMA. O pardmetro seguinte, 
A$3000, jogard para o disco a partir da posi¢ao de memoria 3000 hexadecimal. O A se refere ao 
endereco. A terceira parte L256 especifica o comprimento em bytes da memoria a ser gravada, 
neste caso 256 bytes decimais. O maior comprimento é 32767 decimal ($7FFF hexadecimal). 
O BSAVE permite usar ndmeros decimais ou hexadecimais como endereco ou comprimento. 
Em se usando valores hexadecimais, deve-se colocar o sinal de dolar a frente. 

Os Ultimos trés parametros no exemplo (S6, D1, V201) sAo opcionais. Eles especificam o 
disco a usar. Use o pardmetro S (slot) apenas quando tiver mais de um cartao controlador de disco 
e o disco que deve receber a gravacdo ndo é o mesmo que foi operado quando do Ultimo acesso ao 
disco (nao é o corrente). Usualmente o slot 6 é o padrao. O parametro D (nimero. de drive) é 
util, porém nado necessdrio; ele especifica o nimero do drive apenas se ele difere do Ultimo drive 
acessado, 0 corrente. O pardmetro V (nUmero de volume) 6 o n&mero de volume guardado no 
diretério do disco onde se esta guardando memoria. Se o volume especificado na declaracado 
BSAVE difere do gravado no disco, aparece uma mensagem de erro. 


Lendo para a Memoria a Partir do Disco 


Como foi feito como BSAVE, usa-se o DOS para ler do disco para a memoria. O comando BLOAD 
faz isso. 
Aqui esta um exemplo do BLOAD: 


BLOAD TABFORMA, At 3000 


Este exemplo carrega o arquivo chamado TABFORMA do disco em uso corrente e coloca os 
dados diretamente na memoria, iniciando no endereco 3000 hexadecimal. Esta declaracdo de 
comando também aceita endereco decimal. O parametro A (endereco inicial), ndo é necessario se o 
contetido do arquivo inicia na mesma posi¢do a partir de onde foi gravado. S6 é necessdrio espe- 
cificar endereco se ele for diferente do usado na definicdo de endere¢o inicial do BSAVE. O para- 
metro L (comprimento) é opcional mas nado imprescindivel. O DOS verifica o comprimento do 
arquivo em disco e termina o comando de leitura automaticamente. Os pardmetros de disco 
opcionais do BSAVE (S, D e V) também podem ser usados no BLOAD para especificar slot, drive 
e volume. 

Cuidado para nado usar este comando em dreas de memoria que podem estar ocupadas com o 
DOS, o interpretador Applesoft, paginas de texto ou graficas, ou varidveis BASIC. E possivel que 
se escreva sobre essas partes, destruindo dados que poderdo ser necessdarios mais tarde. 


MOVENDO E COMPARANDO BLOCOS DE MEMORIA 


O Monitor tem duas fungdes que podem ajudar, quando se Ié ou grava memoria em fita. A funcado 
de mover, que copia conteudo de blocos de memoria de uma drea para outra e a funcado de com- 
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parar dois blocos de memoria de enderecos distintos e mostrar as diferencas entre eles. Usados em 
conjunto com os comandos de ler e gravar dados, estas fun¢des fornecem uma maneira adicional de 
controlar se os arquivos gravados tém os dados corretos. 


O Comando de Mover Meméria 


Para mover dados de um endereco de memoria para outro, deve-se fornecer o endereco receptor 
inicial (para onde os dados devem ir), o endereco fonte inicial (de onde os dados partirdo) e o 
endereco fonte final, o Ultimo endereco com dado a ser movido. O formato deste comando é o 
do endere¢o inicial receptor, seguido do sinal de menor ou igual (<), o endereco inicial fonte, um 
ponto, o endere¢co final fonte, e a letra M (de mover). Como outros comandos do Monitor, todos 
os enderecos sao em hexadecimal. 

Por exemplo, 0 comando: 


#¥7200¢ 2000.2100M 

move dados para o endereco 1200 hexadecimal (o endereco inicial do receptor), a partir do bloco 
que inicia em 2000 hexadecimal (o endereco fonte inicial) e finalizando em 2100 (o endereco 
fonte final). O Monitor copia o contetido da memoria, do endereco 2000 até 2100 para os ende- 
recos entre 1200 até 1300, neste exemplo. Como os enderecos sdo em hexadecimal, o compri- 
mento do bloco a ser copiado é 257 bytes decimal, ou 101 bytes em hexadecimal. O contetdo 
original dos enderecos entre 2000 e 2100 ficam intactos. 

Quando se especifica os enderecos no comando de mover, o endereco fonte inicial deve ser 
menor ou igual ao do fonte final. Se o endereco final for menor que o inicial, o Monitor s6 movera 
um byte, para o endere¢o receptor inicial, saindo da operacado de mover. 


Preenchendo Meméria 


O comando de mover memoria também a preenche. Preencher memoria é carregé-la com um ou 
mais bytes repetidamente em enderecos consecutivos. Suponha que se queira colocar zeros numa 
area de memoria, iniciando no endereco 1D00 e finalizando em 1DFF. Usando de forma criativa 
Os comandos de alterar e mover memoria, pode-se preencher areas de memoria com um valor 
pré-determinado, ou padrao. 

Para inicio, deve-se colocar zeros no primeiro byte da memoria: 


*¥1DO0=00 


Este é o primeiro passo para preencher memoria. O segundo usa o comando de mover me- 
moria para copiar 0 contetido de um (ou mais) bytes em um bloco adjacente de memoria. 

Especifique o endereco receptor inicial como um acima do Ultimo byte do padrao (neste 
exemplo, deve ser 1D01). Coloque o endereco inicial do fonte no inicio do padrado (neste caso 
1D00), e coloque o endere¢o final do fonte como o Ultimo a ser preenchido com o padrao (1DFF) 
menos 0 comprimento do padrdo que se quer colocar no bloco de memoria (1DFE). 

Continuando o exemplo, o comando 


*®1D01<1D00.1DFEM 


enche as posi¢des de 1D01 até 1DFF de zeros (ou mais precisamente. com o contetido da posicdo 
1D00). Este processo sé funciona quando o padrdo existe no inicio do bloco que se deseja preen- 
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cher. Aqui esta o que acontece. Como o endereco inicial do receptor é um byte adiante do ende- 
reco inicial fonte, o Monitor mave primeiro o contetdo de 1D00 para 1D01, colocando este 
Gltimo endereco em 00. Quando o segundo byte é movido, vai-se de 1D01 para 1D02. O processo 
continua até que o contetido do endereco 1DFE (colocado em zero na Ultima transferéncia de 
byte) vai para 1DFF. Observando essas posicdes pode-se ver os enderecos de 1D00 a 1DFF preen- 
chidos com zeros. 

Pode-se desejar preencher memoria de 1D00 a 1DFF com um padrao de quatro bytes, sendo 
necessaria a alteracado dos primeiros quatro bytes do bloco: 


¥1000800 SE. 7F FE 
O padrao ja esta la. Para preencher memoria até 1DFF com este padrao, coloque o comando: 
*1(D04¢1D00.1DFB 


Note que o endereco inicial do receptor vem um byte depois do final do padrdo, o endereco 
inicial do fonte aponta o inicio do padrdo e o endereco final do fonte aponta o Ultimo endereco a 
ser preenchido menos 0 comprimento do padrdo: 


1DFF 
—04 (Aritmética hexadecimal) 


1DFB 


Uma vez mais, ao se executar este exemplo pode-se examinar o conteddo de 1D00 até 1DFF 
para observar o padrdo repetido no bloco. 


O Comando para Verificar Memoria 


Este comando do Monitor compra dois blocos de memoria entre si, detectando as diferencas entre 
os dados. Pode-se usd-lo em conjunto com os comandos de leitura e gravacao de memoria suporta- 
dos pelo DOS. Ao se gravar dados da memoria em qualquer dispositivo e querendo saber se o 
processo ocorreu de forma correta, usa-se 0 comando de verificar a memoria. 

O formato para este comando é parecido com o de mover bloco de memoria. Digite o ende- 
reco inicial de destino (onde inicia a comparacdo de memoria) seguido imediatamente pelo sinal 
de menor (<.), 0 endereco inicial do fonte (onde inicia a compara¢do com o destino), um ponto, 
e oO endereco final do fonte (onde fica o Ultimo byte a ser comparado neste comando). O ultimo 
item é a letra V, de verificar. 

Aqui esta um exemplo: 


#32D0¢0.CV 


Com isso o Monitor é instruido para iniciar a comparacao no endereco 32D0 contra o endere¢o 0, 
e continuar a comparacao até o endereco OOOC. Veja que nao é necessario zeros nao significativos 
na indicagdo de enderecos para o Monitor. 

Se o Monitor encontra um byte no bloco fonte que nao coincide com o destino, sao mostra- 
dos o endereco fonte e seu valor, bem como o destino e seu valor. 

Por exemplo, suponha que se move do endereco 0000 até OOOC para os enderecos 32D0 
até 32DC: 
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#:32D0¢0.0M 
e€ em seguida se manda mostrar os blocos fonte e destino: 


#).0 


“t; 
gut 
E32 
ae oe 
cat 
om 
~ 


OOO 40 30 D4 40 3A DB 
OO08~ FF OFF 40 99 £4 


#°32D0.32DC 


32800~ 40 30 D4 40 3A DE Be BC 
22D8~ FF OFF 40 99 E4 


pode-se verificar visualmente a operacdo de transferéncia de dados. Se o endereco 32D8 for alte- 
rado do seu valor atual (FF) para 5A 


HILDB SSA 
e em seguida for dado o comando de verificar memoria 
4320040 «C¥ 


o Monitor vai comprar o bloco fonte com o destino byte a byte até encontrar 0008 contra 32D8. 
Como este Ultimo foi alterado, o Monitor informa a discrepancia 


OOO8-FRF ¢ Sa) 
a 
significa que o valor do endereco 0008 no bloco fonte nao coincide com o mesmo endereco rela- 
tivo do bloco destino (32D8). Primeiro é mostrado o endereco fonte (0008, cujo contetido é FF) 
e depois, entre parénteses, 6 mostrado o contetido divergente do destino (5A). 
O endereco do bloco destino ndo aparece; o Monitor assume que se pode somar facilmente 


nudmeros na base 16 para achar o endereco do destino. Uma forma de evitar o calculo é refazer a 
operacdo trocando o fonte com o destino: 


#14 S2B0., 32DCV 
O que resulta em: 
sabe CP) 
Esta mensagem mostra que o endereco fonte 32D8 contém 5A hexadecimal, com seu corres- 


pondente (endereco 0008 como visto acima) contendo FF. Este método elimina um calculo, mas 
coloca outro; isto 6, deve-se calcular o novo endereco fonte final (32DC). 


Verificando Memoria Guardada em Periféricos do Apple II 


O comando de verificar memoria é especialmente Util quando se guardam dados da memoria em 
fita ou disco. Gravando uma por¢cdo de memoria e lendo para uma drea diferente, pode-se verificar 
se os dados foram gravados corretamente. O exemplo a seguir mostra como executar este processo 
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para programas em linguagem assembler, tabelas de formas, e outras informacdes que se podem 
guardar nos periféricos do Apple II. 

No caso de se usar gravador cassette para guardar memoria em fita, o primeiro passo é dar o 
comando de gravar memoria como mostrado neste exemplo: 


X2000.20F FU 


Este comando grava dados da memoria, iniciando no endere¢o 2000 e terminando em 20FF, 
em fita cassette. Nao se esqueca de acionar a tecla RECORD antes de acionar RETURN. Uma vez 
que 0 alto-falante do Apple I! emite o b/p indicando que o processo de gravacao terminou, desligue 
O gravador e rebobine a fita até onde o tom de referéncia foi dado. Assumindo que existe uma area 
de memoria disponivel de 2100 a 21FF, use 0 comando de ler dados da fita para a memoria a 
partir do endereco 2100, finalizando em 21FF: 


K2100.21F FR 


Nao se esqueca de acionar no gravador a tecla PLAY. Quando o alto-falante do Apple I! emitir o 
bip, a operacdo de leitura estara concluida. Agora entao pode-se comparar o dado gravado com o 
lido da fita: 


*200NC2100.21F FY 


O comando compara memoria iniciando em 2000 até 20FF, com o que esta gravado e foi 
lido do cassette, a partir do endereco 2100. Se nado aparecer nenhuma diferenca, pode-se ter cer- 
teza que os dados foram gravados corretamente. 

Para verificar memoria gravada em disco, o mesmo processo se aplica. Antes de tentar gravar 
ou ler memoria no disco, o Sistema Operacional (DOS) deve também estar presente. Aqui, 0 pri- 
meiro passo é dar um comando BSAVE de bloco de memoria para disco: 


BSAYVE MEMDADG, A2Q00,LEFF 
A memoria guardada em disco pode ser lida de volta com BLOAD: 
BLOAD MEMDADO, At 2100 


Note que o parametro de endereco nesta declaracao é 256 bytes (decimal) maior que o ende- 
reco inicial de gravacdo. Quando o arquivo MEMDADO 6 lido, 0 comando de verificagéo compara 
os dois blocos: 


GALL «43517 
*200042100.21F FV 
Se nao ocorrer diferencas, pode-se estar certo que os dados da memoria foram gravados 


corretamente no disco; de outra forma, o Monitor vai apontar as diferencas entre os blocos de 
forma que se possa Corrigir. 


O COMANDO GO 


O Monitor tem um comando que transfere o controle do Apple || para o programa no endereco 
que se especifica. No inicio deste capitulo viu-se como deixar o Monitor e voltar para o Applesoft 
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em disco. O comando: 
#3D0G6 


instrui ao Monitor para pular para o endereco 3D0 e executar instrucdes em linguagem de maquina 
a partir de la. A letra G no final da linha de comando vem de GO. Se esta instru¢ao for dada com o 
DOS na memoria, o endereco 3D0 terd a primeira parte da instrucado em linguagem de maquina: 


JMP S9D8F 


Quando o Monitor transfere o controle para o endereco 3D0, o computador pula para o 
endereco 9DBF, onde as rotinas do DOS iniciam. 

A forma geral do comando GO é o endereco para onde o controle vai, seguido da letra G. 
O endereco é opcional, o Monitor usa o apontador de memoria se ele nao for fornecido. 


USANDO A IMPRESSORA 


Se o Apple II esté conectado a uma impressora via Interface Serial ou Cartéo de Comunicacao, 
pode-se usd-la para safda de dados. Para transferir a safda do video para a impressora, coloque o 
numero do slot onde esta localizado o cartao de interface, seguido de CTRL-P e RETURN. Uma 
vez dado este comando, toda a safda normalmente colocada no video sera transferida para a 
impressora. Para voltar a safda para a tela, use numero de slot 0 com o comando CTRL-P. 

Quando for usado este comando, verifique que exista mesmo o cartao de interface no siot 
especificado. Se for indicado um lugar sem cartéo, o Apple II ira travar, e a Unica forma de sair 
sera acionando o RESET. 

Os comandos de impressora operam exatamente como o comando PR# (numero de slot) 
do BASIC. Ambos operam a chave CSW de dois bytes (chave de safda de caractere) no endereco 54 
($36). Esses dois bytes contém o endereco que aponta para a rotina de safda de caracteres corren- 
te. Trocando o nimero do slot com CTRL-P, troca-se o endereco dessa chave. 


OS COMANDOS DE TECLADO 


Este comando direciona o Monitor para aceitar entrada via outro dispositivo que nao o teclado 
do Apple II. Digite o numero do slot e CTRL-K, acionando entéo RETURN. Para voltar para o 
teclado, digite o mesmo comando com numero de slot 0. 

Neste caso é atuada a chave KSW (chave de entrada via teclado) no endereco 56 ($38) 
sendo colocado o endereco do dispositivo de entrada que for colocado no teclado. 


INDICANDO MODOS DE DISPLAY 


Para que o Monitor se apresente em modo video reverso, entre 0 comando de inverter, abre- 
viacdo |. Isso fara com que tudo 0 que o Apple I! mostra na tela seja colocado como letras brancas 
em fundo preto. Entretanto, todos os comandos do Monitor digitados ficaraéo em modo video 
normal. 
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Para sair do modo inverso, digite 0 comando para video normal, abreviagdo N. Nenhum 
destes comandos necessita de parametros adicionais, além das letras | ou N. 


ARITMETICA BINARIA EM OITO BITS USANDO O MONITOR 


O Monitor executa funcdes de adicdo e subtracao em oito bits. O resultado obtido também se 
apresenta com oito bits. Para executar adi¢cdo, digite a primeira parcela hexadecimal seguida pelo 
sinal (+), seguida pela segunda parcela. Se o resultado é maior que FF, o Monitor trunca o dfgito 
mais significativo e mostra os oito bits menores do resultado, como mostrado neste exemplo: 


#7 F+BA 
=O9 


Para executar subtracao, digite o minuendo, seguido pelo sinal (—) e o subtraendo. Como na 
adi¢ado, ambos os nuimeros devem ser hexadecimais. Se o resultado for menor que zero, o Monitor 
mostrara o complemento do resultado em 1, como se vé abaixo: 


xOA~20 
=H 


COMANDOS DO MONITOR DEFINIDOS PELO USUARIO 


Digitando-se CTRL-Y no Monitor, pode-se chamar uma rotina especial definida por usuario. O Mo- 
nitor pula automaticamente para o endereco hexadecimal 3F8 ao se entrar com CTRL-Y. Nesse 
local existe espaco para uma instru¢do de jump em linguagem de maquina. Se existir alguma rotina 
em linguagem de maquina para acessar dentro da maquina, o endereco inicial dessa rotina deve ser 
colocado em 3F8. 

O exemplo abaixo mostra como usar o CTRL-Y para reiniciar o Applesoft em disco sem ter 
que redigitar o conhecido comando 3DOG. 

Primeiro, deve-se conhecer o formato da instrucdo jump em linguagem de maquina. Ela 
ocupara trés bytes. O primeiro é o cédigo da instrugdo, 4C. Os dois bytes seguintes so o endereco 
para onde sera dado o salto, com os bytes trocados. Deve-se indicar o byte de menor valor 
primeiro (parecido com informar o sobrenome primeiro). 

Aqui esta um comando de alteracdo de memoria para orientar o salto para o endereco 3D0: 


*¥3FE°4C0 DO O03 


Tente agora o CTRL-Y. Isso é bem melhor que 3D0G! 
Para outro exemplo, veja como se pode usar o CTRL-Y para ir ao Mini-Assembler, descrito 
na sec¢do seguinte em detalhes. Digite o comando do Monitor: 


*F E666 


aparece o Caractere de entrada do Mini-Assembler: 
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O endereco onde o Mini-Assembler inicia, F666, pode ser usado na instrucao de salto em 
3F8: 


PSFOESIMP £F466 
DSF o- 4; G&G FS JMP $F 44&& <— O Mini-Assembler 
: mostra esta linha 


Embora o Mini-Assembler ndo tenha sido estudado até agora, a linha acima altera o endereco 
da instrugdo jump em 3F8 hexadecimal para $F666, que é o endereco onde inicia o programa 
Mini-Assembler. Para voltar ao Monitor, digite o comando: 


$e A OG 

% 
Aparece o caractere de apresentacdo do Monitor na parte inferior esquerda da tela. Em seguida, se 
for acionado CTRL-Y, aparecerd o caractere do Mini-Assembler. Operando como o comando defi- 
nido por usuario para acessar o Mini-Assembler, elimina-se a digitacdo de enderecos. Altere o 


comando definido pelo usudrio colocando um endereco diferente na instrucdo de saldo no ende- 
reco 3F8. 


O MINI-ASSEMBLER 


No Apple || padrao (ou cartdéo Integer BASIC com Apple I! Plus), existe um programa em ROM 
que permite ao programador em linguagem de maquina evitar a tortura de montar o programa. 
O Mini-Assembler é acoplado ao Integer BASIC em ROM. E chamado de Mini porque o progra- 
mador precisa usar enderecos literais, ao invés de rotulos mnemOnicos, como operandos nas 
declaragdes em linguagem assembler. Além disso, cada linha de cdédigo digitado é automéatica e 
imediatamente montado em linguagem de maquina. O principal problema aqui é que nao se pode 
inserir ou eliminar instrug¢des, como se faz usando montadores assembler completos junto com 
editores de texto. 

A principal vantagem do Mini-Assembler é sua habilidade de entrar instrucdes em linguagem 
de maquina diretamente no Apple II, embora mantendo a facilidade de se operar com os mnem6o- 
nicos das instrugdes na linguagem assembler. 

O resto deste capitulo descreve o Mini-Assembler e diz como usa-lo. Ele nao ensina concei- 
tos de programacdo em assembler, nem mostra o conjunto de instrucdes do 6502 que o Apple I! 
usa. 

Assim, se houver ainda dificuldade de entender coisas como assembler, operandos, mnemo- 
nicos etc., para por aqui. Aprenda primeiro as técnicas de programa¢ao em assembler e as instru- 
¢des do 6502. Depois termine de ler este capitulo. 


ACESSANDO O MINI-ASSEMBLER 


O ponto de entrada do programa mini-assembler 6 F666 hexadecimal. Para partir vindo do Monitor, 
digite 0 comando: 
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#E OS SG 


Isso causa o salto do Monitor para o Mini-Assembler. Estando em Integer BASIC ou Applesoft 
(verses em disco ou cassette), entre o comando de modo imediato: 


CALL -2458 


Ao entrar no mini-assembler o alto-falante da um b/p. O caractere de entrada do Mini-Assem- 
bler 6 o ponto de exclamacao ( ! ). 


Erros Entrados 


O Mini-Assembler detecta erros na digitag¢do de instru¢des em linguagem assembler. Ele mostra os 
erros com bip no alto-falante e mostrando a instrucao errada com o sinal ( ) sob o primeiro 


Caractere incorreto da instrucdo. O contador de posicdes nao é incrementado; ele permanece 
intacto de forma que se pode redigitar a instrucao corretamente. 


COMANDOS DE MONITOR NO MINI-ASSEMBLER 


A qualquer momento dentro do Mini-Assembler, pode-se executar comandos do Monitor. |media- 
tamente a apresentacdo da exclamacdo (!), digite o sinal délar ($), seguido do comando do 
Monitor. O exemplo abaixo mostra como examinar contetido de memoria a partir do Mini-Assem- 


bler: 


tS TLS 
4CrF ES 


Isso elimina a perda de tempo em se ir e voltar do Mini-Assembler ao Monitor. Pode-se digi- 
tar qualquer comando do Monitor estando no Mini-Assembler, apenas entrando o sinal délar como 
primeiro caractere do comando. De fato, esse procedimento também deve ser usado na safda do 
Mini-Assembler. 


DEIXANDO O MINI-ASSEMBLER 


Para deixar o Mini-Assembler, use um dos comandos do Monitor, com o sinal délar como prefixo. 
Para voltar ao Monitor, pule para o endereco FF69 com o comando $FF69G. 

$CTRL-B e $CTRL-C, mandardo para o BASIC, exceto se estiver sendo usado o Applesoft 
em disco ou cassette. Para Applesoft em disco use $3DOG, e para Applesoft em cassette $0G. 


FORMATOS DA INSTRUCAO 


Embora nao seja o objetivo desta secdo ensinar programacdo em linguagem assembler, existem cer- 
tos aspectos do Mini-Assembler que devem se~ bem conhecidos antes que se possa usé-lo. Primeiro, 
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ele mantém um apontador de instrucdo separado do apontador de memoria do Monitor. Deve-se 
acertar este apontador antes de se entrar com instrucdes. Segundo, existem varios formatos de 
instrucGes usados na programacaéo do microprocessador 6502. Estes formatos dependem em 
grande parte do esquema de enderecamento usado. 

O microprocessador 6502 tem onze modos de enderecamento, mas apenas seis formatos de 
instrug6es separados. Eles sao descritos abaixo. 

O primeiro, modo absoluto e direto, requer apenas o endereco de memoria do operando com 
um ou dois bytes. Por exemplo: 


AND $9058 


O Mini-Assembler nado requer o sinal de délar ($) antes de enderecos em hexadecimal; ele assume 
que todos os enderecos estado na base 16. 
O segundo formato é o de enderecamento imediato, como no exemplo: 


LA HES 


Veja o sinal (#) como primeiro caractere do operando. Ele é um indicador explicito de que 
o valor 04 sera carregado no Acumulador. Sem este sinal, o Mini-Assembler interpreta a instrucao 
como “pegue o contetido da posic¢do de memoria 0004 e coloque-o no Acumulador’’, que é uma 
instruc¢ao que referencia endereco absoluto. 

Perceba também o uso confuso do termo imediato. Nao confunda enderecamento imediato 
da linguagem assembler com execucdo imediata de programa em BASIC. As operacées sao dife- 
rentes. O termo é o mesmo e é usado de forma ambigua. 

O terceiro formato é o método indexado, que se parece com: 


LMP $259% 


ou 
AND $00» ¥ 


Ambas as instrugdes sdo semelhantes na medida em que os registradores X e Y aparecem 
como segundo operando. Basicamente, este formato gera uma instrucao em linguagem de maquina 
que adiciona o contetido do registrador X ou Y ao endereco colocado no primeiro operando, e 
usa a soma Como um endereco a ser referenciado pela instrucao. 

Agora, 0 formato indireto pré-indexado, como neste exemplo 


ANID CEFO, 4) 


indica que a soma do endereco ($FO) e do contetido do registrador X aponta para um endereco 
dos primeiros 256 bytes da memoria que, por sua vez, contém outro endereco que aponta o dado 
a ser usado na operacao da instrucdo. 

O modo de enderecamento indireto pds-indexado tem a seguinte forma: 


QRA Costs. ¥ 


Este formato de instrucdo usa o primeiro operando como apontador de um endereco de dois 
bytes, localizado, neste caso, na posi¢do $22. A instrucdo soma o contetido do registrador Y ao 
endereco encontrado em $22; o dado no endereco derivado é usado na instrucdo em linguagem de 
maquina. O Mini-Assembler reconhece enderecamento indireto pds-indexado quando o primeiro 
operando esta entre parénteses, como no exemplo acima. 
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O enderecamento indireto é um pouco mais direto que o indexado. Aqui esta um exemplo: 

JMP C#22FE3 
Aqui, a instrugao JMP nao carrega o endereco $22FE no contador de programa. Em vez 
disso, o endereco de dois bytes da posi¢ao $22FE é carregado no contador de programa. Dessa 


forma, 0 operando no formato indireto é em verdade um apontador ao invés de um endereco 
literal. 


USANDO O MINI-ASSEMBLER 


Como visto na se¢ao anterior, o Mini-Assembler mantém um contador de posicao que é incremen- 
tado do tamanho de cada declaracdo em assembler entrada. Em outras palavras, uma vez digitada 
uma declaragdo em linguagem de maquina (toda a vez que se digita uma instrucdo), o Mini-Assem- 
bler calcula seu comprimento (1, 2 ou 3 bytes) e incrementa o contador de posicdo para a linha 
seguinte. 

O primeiro passo no uso do Mini-Assembler 6 acertar o contador de posicao. Faca-o como 
parte da primeira declarag¢do em linguagem de maquina digitada. Por exemplo: 


'SDBOELDA #EO4 


Imediatamente apds o caractere de entrada do Mini-Assembler, digite o endereco base para 
Os cédigos em linguagem de maquina a serem entrados (neste caso, 8DBO), seguido de dois pontos 
(:) e a primeira declaragéo em linguagem assembler. Nao seré necessdrio digitar a posicao para a 
declarac¢ao seguinte. O Mini-Assembler calcula o endereco seguinte, a menos que se va colocar 
instru¢des em outro endereco fora da sequéncia, como mostrado acima. 

Uma vez posicionado o contador de posicdo, entre as instruc¢des em linguagem assembler, 
uma por linha. Apés a primeira linha, entre um espaco seguido pela declaracdo seguinte, como aqui: 


! JSR FBTE 


Isso leva o Mini-Assembler a calcular o valor seguinte do contador de posicao. 


Uma Secdo de Exemplo 


Esta se¢do mostra a operacdo do Mini-Assembler passo a passo e em detalhes. O seu objetivo é 
criar um pequeno programa que use as entradas de controle de jogo do Apple I! e o alto-falante 
para criar sons. O procedimento para este programa é ler valores dos paddles 0 e 1, usando a sub- 
rotina PREAD (no endereco FB1E). O valor do padd/e 0 dara o intervalo entre os sinais do falante 
(O=menor atraso, FF=maior atraso), e o valor do paddle 1 sera outro intervalo, inversao ao 
paddle 0 (0=intervalo mais longo, FF=intervalo mais curto). 

O programa inicia em 1D00 e usa o endereco 1CFF para guardar a leitura do paddle 0. 

Quando se entra cada linha do programa em linguagem assembler, o Mini-Assembler sobre- 
poe a linha entrada com o valor do contador de posic¢ao corrente, cOdigo de operacdo e operando 
em forma de linguagem de maquina (também conhecida como cédigo objeto), bem como o mne- 
mOnico da instrucdo digitada. Por exemplo: 


41D00- Ae OO Lox REOO 
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O contador de posicao é mostrado no inicio da linha seguido por um traco. Apos esse 
campo, 0 cddigo de operacado (A2 para a instrucdo LDX) aparece, seguido pelo Ultimo byte da 
instrug¢do. No caso de instrucdes de trés bytes (aquelas que referenciam enderecos de dois bytes), 
o byte de menor ordem aparece antes do de maior ordem. Por fim, é mostrado o cédigo mnemo- 
nico da instrucao. 

O exemplo mencionado aparece abaixo. Veja que cada linha produzida pelo Mini-Assembler 
aparece aqui sob a linha entrada que a gerou. 


{OOO 8 Ls #400) <— Acerta o contrador de posicdo e da a primeira instrucado 


'OOO- met UL) Lox 8€00 

[ JJ FETE <— Todos os ntimeros sao hexadecimais (nao é necessario o prefixo $) 
oo Pe ae) 4&E FB JSR ¢FB1E 
; SLY WCF 

1V05- OG Fr 4G STY t4cCrr 
' TNX 

Tote b £3 TWX 

t Sk FBTE 

qe -- “0 TE FB 35k €FBTE 
fr Loe COSG 

1BOC- AD 3O LpA £00350 
i: DEC ACFF 

4Q0F - CE FF To SEC SCF 
' ME 001 <— O Mini-Assembler calcula o salto relativo (F8) 
1 2 DO FE ENE €1D0C 
P LbaA COS 

Toda AD 30 CO LDA = 8€0030 
' NY 

1047 = oS THY 

1 BME ID 

IDiB- ON FA BNE ¢1074 
| .MP FDO 

tata 4 0 JMP 41000 


Apos digitar este programa, confira. A melhor forma de fazer isso é listaé-lo na memoria, de 
preferéncia no formato em linguagem assembler. Para isso sera necessdrio usar o Monitor como se 
vera a seguir. 

Como seguran¢a adicional, pode-se guardar o programa em cassette (comando W no Monitor) 
ou disco (com a declaracéo BSAVE do BASIC). 

Para rodar o programa, pule para o endereco 1D00. Use 0 comando G no Monitor, ou 
CALL 7424 no BASIC. Opere com os controladores de jogo e veja como eles afetam o alto-falante. 
Para finalizar o programa, acione RESET. 


LISTAGEM DE DESASSEMBLER 


O Monitor tem um comando que pode ser usado para listar instrugdes de maquina em formato 
de linguagem assembler, mesmo que o Apple II! nao tenha o Mini-Assembler em ROM. O comando 


252 APPLE II 


L, de Listar, faz desassembler de 20 instrugGes de linguagem de maquina para declaracdes em 
assembler mostrando-as na tela ou em outro dispositivo selecionado. O comando L usa o contador 
de posi¢ao como apontador para a proxima instrucdo a ser operada no desassembler. Dessa forma, 
digite L apds entrar com o programa acima, e o processo se iniciaré no endereco 1D1D, sem 
mostrar nada do que foi digitado. 


E bom acertar o contador de posicao ao usar o comando L. Aqui esta a listagem do programa 
exemplo acima: 


b$ PDO OL 


1D ase oo LOX #00 
1D0@- 20 4E FE JGR $F B4E 
1DNS- Bo FF de STY $4 0FF 
{p08 £8 TNY 

Ape 20 4E FB JGR $F BIE 


? 
WA $0020 


qpoc~ ad 30 co | 

1pOF- CE FF 4c DEC #$1CFF 
ipi2- pn Fs PME $4DNe 
1D1i4- ad 30 co LbA #C03C 
iDiy- ce INY 

iDis- oO FA BNE #4D414 
iDia~ 40 00 4D IMP ¢4p00 
ADID- OF 279 

1DIE~ 46 AS 12 LSR $1245 
1D21~ Aa OS LDY #94 
1029- Ag oO? 

ipe4~  bO Ad BNE #41CCA 
1D26~- EF v2? 

1De7- AS G2 LDY  %42 
2 LOX Ne? 


Neste caso, as oito Ultimas instrucdes do desassembler sao imateriais, porque o programa termina 
no endereco 1D1A. 

Veja que o comando L é uma facilidade do Monitor, independente do Mini-Assembler, 
(portanto com o dolar como prefixo). Entrando com L (ou $L no Mini-Assembler) e acionando 
RETURN sem dar a posi¢cao inicial do contador, o Monitor lista o desassembler das proximas 
20 instrucdes que encontrar depois das que foram listadas. 


TESTANDO E DEPURANDO PROGRAMAS 


Junto com o Mini-Assembler, o Monitor do Apple II padrao oferece ferramentas de depuracao 
que ajudam muito quando se programa em linguagem assembler. Os programas em linguagem de 
baixo nivel sao provavelmente os mais dificeis de depurar e testar. Ao invés de simplesmente mos- 
trar contetido de variaveis, deve-se inspecionar posicdOes de memoria, registradores e 0 programa 
em si. Dois comandos do Monitor, Step e Trace, sao usados para esse proposito. 


Tanto o Step quanto o Trace nao sao disponiveis na versao do Apple |! com o Autostart 
Monitor. 
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O Comando Step 


Embora seja bastante facil testar um programa em linguagem assembler observando os sinais de 
execucdo de suas operacdes, este ndo 6 um método muito eficiente de isolar os erros. Se o pro- 
grama é pequeno, fica possivel roda-lo passo a passo, verificando os resultados de cada instru¢ao a 
linguagem de mdquina apds sua execucdo pelo Apple II. Isso é o que se faz através do comando 
Step. 

Quando se executa um comando Step, o Monitor desassembliza e mostra a instrucdo apon- 
tada pelo contador de posicdes, executa-a, mostra o conteUdo dos registradores do microproces- 
sador, e volta o controle para o Monitor do Apple II. 

O formato do comando Step é um pardmetro de endereco opcional (para posicionar o con- 
tador de posicao) seguido da letra S. 

O comando Step abaixo executa a primeira instrucdo do nosso programa exemplo de gerac¢do 
de sons. O contetido do registrador X mostrado é 0. Os outros trés registradores cujos conteudos 
sao mostrados n4o se alteram. 


# ({DOOS 
1000~ fet TO Ls 4 SOD 


AskRF ‘YefigQ yv<8c “9 


re 
t 
3 
wt 
it 
OO 


Pode-se misturar 0 comando Step com outros do Monitor (tal como examinar memoria). Para ver 
isso em acdo, va através do programa de sons até a instrucao STY na posi¢ao de memoria 1D05. 
Ser4 necessdrio entrar com o comando S nove vezes, porque a instrucdo JSR na posi¢ado 1D02 
chama uma sub-rotina na posicado FB1E e deve-se percorré-la passo a passo até que se volte para 
1D05. Uma vez la, use 0 comando de examinar memoria do Monitor para ver a posicdo 1CFF. 
A instrucado no endereco 1D05 guarda o que foi no padd/e 0 no endereco 1CFF. 


eS 

1D03- BO tr AC SiY SS 1Chr 
A=PR £200 Y¥=O00O P=S2 S=F a 

*1 CEFF 

10FF~ 00 


Como se pode ver com 0 comando de examinar memoria, o contetido do registrador Y (3F) agora 
esta guardado no endereco 1CFF. Pode-se também misturar outros comandos do Monitor com o 
comando Step. 


O Comando Trace 


Muitas vezes o programa é muito longo para que se execute cada instrucdo passo a passo. Em vez 
disso, fica mais interessante que as instrucdes sejam executadas e so se interrompa a execucao 
quando for necessdrio. O comando Trace do Monitor faz isso. Sua safda é semelhante a do Step, 
com excecdo ao fato que o Trace elimina o trabalho de se colocar a instrucado Step para cada 
instrucao executada pelo Apple II. Para parar com o comando Trace, acione a tecla RESET ou 
entre a instrucdo assembler BRK no programa; quando o Monitor encontra esta instrucdao, ele 
devolve o_controle para o teclado (via Monitor). 
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O formato do comando Trace é constitufdo de um enderego opcional seguido da letra T. 
Aqui esta a primeira parte da execucae do trace no programa de sons do exemplo: 


*1DOOT 

4D00~- Az oo LDX ##00 
A=FF X=00 Y=8C P=32 S=F6 
4D02- 20 4E FB JSR $FB4E 
A=FF X=00 Y=8C P=32 S=F4 
FRIE~ AD 70 CO LOA #co70 
A=00 X=00 Y=8C P=#32 S=F4 

FB21~ ad oo LOY #s00 

A=00 X=00 Y=00 P=32 S=F4 

FR23- EA NOP 

A=00 X=00 Y=00 P=32 S=F4 

FE24~ EA NOP 

A=00 X=00 Y=00 P=32 S=F4 

FB25- BD 64 CO LDA #00464,X 

A=00 X00 Y=O0 P#32 S=F4 

FR28- 40 04 BRL $F BSE 

A=00 X=00 Y=O00 P=32 S=F4 

FBGE- 40 RTS 

A=00 X=O00 Y=00 P=32 S=F4 

1D05- SC FF 4c STY s$4CFF 
A=00 X=00 Y=O00 P=32 S=K4 

4D08- £8 TNX 

A=00 X=O04 Y=O0 P=32 S=F4 

4D09- 20 4E FB JGR  $FB4E 
A=00 X=O04 Y=O00 P=30 S=Fé 

FBIE- abd 70 cO Loa ¢c070 
A=27 X204 Y=O00 P=30 S=F4 

FB24~ Ad oo LDY #400 

A=27 X24 Y=OO0 P=30 S=F4 

FB23- EA NOP 

A=27 X=04 Y=O0 P=30 S=F4 

FR24- EA NOP 

A=27 X=04 Y=O00 P=20 S=F4 

FB25- BD 64 CO Loa $0064. x 

A=27 X=04 Y=O0 P=30 S=F4 

FE28- 10 04 BPL $F BSE 

A=27 X=O04 Y=M0 P=30 S=F4 

FB2E- 40 RTS 


A desvantagem em se usar 0 comando Trace sobre o Step é que se tem menos controle sobre 
a execucdo de cada passo do programa. Quando se entra o programa pela primeira vez, deve-se 
colocar a instrugdo BRK em pontos-chave. Essas sao as jun¢des na logica do programa. E légico que 
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se pode trocar essas instrucGes por instrucdes NOP (cédigo de nado operacdo), porém isso nao é 
interessante depois de se ter depurado o programa. 

Adicionalmente, 0 comando Trace opera numa fracdo do tempo gasto pelo programa em lin- 
guagem assembler. Por exemplo, tente substituir no programa exemplo, a instrucao do endereco 
1D1A por um BRK. Digitando o comando 1D00G esta instruc¢do leva uma fracao de segundo para 
ser executada. Entretanto, digitando 1DOOT, o programa leva de 60 a 70 segundos para ser execu- 
tado. Portanto, tendo um programa grande para ser testado, seja moderado com o comando 
Trace se desejar alguma ajuda dele. 


Mais sobre o Contador de Posicédes 


Como foi mencionado antes na secdo sobre o Comando Step, pode-se usar muitos comandos do 
Monitor alternados com o Trace e o Step. Entretanto, existem algumas excecdes a essa regra. Os 
comandos List, Go e o definido pelo usuario CTRL-Y modificam o contador de posi¢do quando 
sdo digitados. Isso altera o fluxo do programa que se esta rastreando a menos que se devolva o 
contador de posicao apds a execucdo de qualquer um deles. O exemplo abaixo mostra como o 
valor do contador de posicdo é alterado usando um desses comandos: 


#41 DOUS 
1b00- az oO LDX #400 
AH62 X= Ye)O P82 S=FB 


96S 

4e~ wy a Fe Jon SFBIE 

AsS&2 Kal You Pxse S=Fe 

a (.. <= Comando de listar aqui 
ree At 7 CO WOR #0070 
rFeLIT= Al OO Loy #800 
re2o* Fe HOF 
Pea = MOP 
Bea Bl 4% CQ LOA #0 O&4, ¥ 
BES ot ES = VO th BFL $FB2E 
FE Gt AA Ce TMY 
FELE= DO FS BME $F BLS 
TRep- et DEY 
Fret = 40 Ris 
FEE - as OT) LOA REDD 
Peoi Ho 48 STA #48 
FE ZS- AD Ss CO PDA BOOS 
PESé- Ai Moy CG) Lm $004 
Pee AL 4] 0 LD ‘ CO 
Pee Ay TD LDA £00) 
PESE~ BO OB BEG &F rb 4B 
FE St AG SO fo Lore $0080 


PE Si - AD So MD LDA $0053 
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FES 4 & -- 20 34 FS JSR GFB26 
% S < Trocando o contador de posicdo, o proximo passo 
sera em $FB49 em lugar de $FB1E 
rE 4o~ AP 14 LDA #814 
A= T4 X=O0 Y=O00 P30 S=F 6 
¥S 
FES 4 £3 - BY 2e STA #22 
A=T4 *=O0 Y=O00 PeSO S=Fé6 
# 


Sub-rotinas Uteis do Monitor 


Em alguns casos, o BASIC nao é suficientemente poderoso para executar todas as funcdes neces- 
sdrias em um programa. Isso, claramente, é uma das raz6es pelas quais os programadores recorrem 
a sub-rotinas em assembler em seus programas BASIC. Esta secdo mostra como referencia-las 
dentro de um programa BASIC. 

Pelo uso de programas em linguagem assembler dentro de BASIC, pode-se criar tantos pro- 
blemas quanto os que se propée resolver. Em que lugar da memoria ficard o programa assembler? 
Lembre-se de que a memoria do Apple I! tem quatro grandes areas reservadas (pagina de texto, de 
graficos de baixa resolucdo e duas paginas de graficos de alta resolucdo). O DOS e o interpretador 
do Applesoft também usam memoria. Colocar um programa onde nao cause problemas, depende 
do tamanho da memoria e da versdo do Apple |! usada. 

O Monitor é a melhor fonte para sub-rotinas em linguagem assembler por trés raz6es: pri- 
meiro, sendo em ROM, nao é necessdrio se preocupar com codigo relocavel. Segundo, as rotinas 
do Monitor estado depuradas; e Ultima, as rotinas intrinsecas ndo usam um byte adicional sequer. 
As sub-rotinas Uteis do Monitor estdo listadas no Apéndice D. 


Incorporando a Sub-rotina 


Decidindo usar uma sub-rotina do Monitor dentro de um programa em BASIC, primeiro certifi- 
que-se que ndo ha nada em BASIC equivalente a ela. Isso pode evitar que um programa seja mais 
complicado que o necessario. Em seguida, verifique se a rotina precisa de parametros passados a 
partir do programa em BASIC. Se for necessdrio atribuir valores aos registradores do microproces- 
sador antes de executar a sub-rotina, ou se o seu resultado vem dentro de registradores, sera neces- 
sario usar instrucdes em assembler adicionais para interfacear com o BASIC. Muitas sub-rotinas 
do Monitor nado precisam de pardmetros do BASIC; aquelas que precisam, em geral tem equiva- 
lentes no BASIC. 

Uma vez sabido qual sub-rotina usar, 6 aconselhavel documenta-la a fim de tornar mais 
clara a operacao. Por exemplo, CALL-936 limpa a tela e coloca o cursor no alto a esquerda. Uma 
forma de tornar esse CALL mais descritivo é gerar uma variadvel no inicio do programa, como 
aqui: 


10 LIMPTELA=~-936 


e para referéncia mais tarde no programa: 
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W510 CALL LIMPTELA 


Isso torna a fun¢do mais clara a qualquer um que mais tarde venha a ler o programa, porém 
insere uma variavel a mais. Esses elementos de estilo tornam o programa bem mais facil de serem 
lidos e entendidos. 


Problemas a Evitar 


Tendo um editor/assembler disponivel para o Apple II, é facil relocar programas reposicionando o 
ponto de origem e reassemblizando. Por outro lado, pode-se escrever uma sub-rotina em linguagem 
de maquina com o Mini-Assembler, usada com o BASIC. Esta alternativa pode gerar problemas 
de incompatibilidade, tendo-se muitas vezes necessidade de reescrever a sub-rotina para outra 
versao do Apple Il com tamanho de memoria diferente. Isso acontece quando se usam areas de 
memoria ocupadas com o DOS, as paginas graficas ou o Applesoft em disco ou cassette. Use as 
sub-rotinas do Monitor sempre que possivel. 

Com programas em Applesoft, use sempre a funcdo USR se tiver que passar parametros de 
ou para a sub-rotina, ao invés da declaracdo CALL. Os enderecos 9D até A3 guardam valores 
passados pelo USR, e pode-se usar esta area para passar pardmetros de volta ao BASIC. Use a decla- 
racao POKE para colocar a instruca€o JUMP nas posicdes 10 até 12 (OA até OC hexadecimal). 
Estas posicdes devem conter uma instruca€o JUMP para o inicio da sub-rotina em linguagem de 
maquina chamada pelo USR. 


INTEGRACAO DO PROGRAMA COM O BASIC 


Em BASIC, as declaragdes LOMEM: e HIMEM: protegem o programa em assembler de ser ‘‘suja- 
do” pelo BASIC. Existem algumas restricdes na determinacdo de um programa em linguagem 
assembler se também tivermos o Applesoft em disco ou cassette ou ainda o DOS na memoria 
ao mesmo tempo. A forma geral ao se usar sub-rotinas em assembler com programa em BASIC 
é a seguinte: 

. Carregue o DOS. 

. Carregue o interpretador Applesoft do disco ou cassette, se necessario. 

. Informe os valores para LOMEM: e HIMEM:. 


. Carregue 0 programa em linguagem assembler. 


Pm WO NO — 


5. Carregue o programa BASIC do disco ou fita (ou digite-o). 


O DOS e o interpretador Applesoft mexem com o HIMEM: apos serem carregados. Deve-se 
reposicionar LOMEM: e HIMEM: para dar espaco ao programa em assembler, e em seguida car- 
rega-lo em lugar seguro. Em seguida, carregar e rodar um programa BASIC afetara apenas a drea 
entre o LOMEM: e o HIMEM:. 

Para maior ajuda em como achar espaco para programas em linguagem assembler, veja o 
mapa de memoria no Apéndice G. Veja também as referéncias ao LOMEM: e ao HIMEM: no 
Capitulo 8. 


S 


Compéndio de 
Declaracoes do Basic 


Este capitulo descreve a sintaxe de todas as declaracGes e funcdes do BASIC do Apple II. As decla- 
ragdes sao descritas em primeiro lugar, listadas em ordem alfabética. A seguir vém as funcoées, 
descritas e listadas também em ordem alfabética. 

Este capitulo serve como referéncia para todas as declaracdes e funcdes. O Capitulo 3 até o 
7 descrevem conceitos de programacdo. Sdo também dados exemplos de emprego de funcdes e 
declaracdes em programas. 


MODOS IMEDIATO E PROGRAMADO 


Muitas declaragdes podem ser executadas em modo imediato ou programado. A menos que se espe- 
cifique 0 contrario, assuma que uma declaracdo pode ser usada em ambos os modos. As excecdes 
sao identificadas. Existem declaracdes que sao restritas a um modo de operacao, nao funcionando 
no outro, outras existem que, embora operando nos dois mddulos, somente em um deles sdo 
praticas. 

Algumas declaracdes se reportam ao DOS (Disk Operating System). Elas podem ser emprega- 
das em modo imediato, como foi mostrado. Em modo programado, entretanto, elas devem ser 
inseridas como parte de uma declaragdo PRINT, antecedidas pelo caractere CTRL-D (cddigo 
ASCII 04). Assim, as duas declaracdes abaixo sao equivalentes: 


ICATALOG 
JPRINT CHRé (495 “CATALOG” 


Veja que em vez de se usar CHR$(4) como visto acima, pode-se digitar o sinal de aspas, 
seguido por CTRL-D, e outro sinal de aspas. Na tela sO aparecerao as duas marcas de aspas, sem 
nada entre elas. O caractere CTRL-D estara |4, porém nao poderd ser visto. 
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VERSOES DO BASIC 


Todas as declaracdes e funcdes sdo disponiveis tanto em Integer BASIC quanto em Applesoft a 
menos que seja especificado o contrario. Onde uma declaracao ou funcdo operar diferentemente 
para as duas versOes, havera a anotacao. 


CONVENCOES DE NOMENCLATURA E FORMATO 


Usaremos um esquema padrdo para apresentar a forma geral de cada declarac¢ao e fun¢ado. Abaixo 
estado listadas pontuacdes e outras convencdes mecanicas que usamos. 


tt Chaves indicam uma escolha de itens. Um dos itens do grupo deve estar 
presente; as chaves ndo aparecem em uma declaracao real. 


tf ] Colchetes indicam que o pardmetro interno é opcional; os colchetes nado 
aparecem em uma declaracao real. 


Indica que o procedimento anterior pode se repetir; nado aparece em uma 
declaracao real. 


Numero de Um numero de linha inicial 6 sempre aplicado para declaracdes em modo 
linha programado. 

Outras Todas as outras marcas de pontuacao — virgulas, dois pontos, aspas e 
pontuacGdes parénteses — devem aparecer como mostrado. 


MAIUSCULAS As palavras em maitisculas devem aparecer exatamente como mostrado. 


[talicos Italicos so usados para termos genéricos. O programador informa a pala- 
vra ou valor exato, de acordo com a forma genérica descrita abaixo. 


Os termos genéricos em itdlico seguintes sido usados em definicéo de declaracdes e funcoes. 
Qualquer termo italico nao listado aqui é particular 4quela funcao em que aparece, e la é descrito. 


col Numero de coluna para grafico de baixa resolucao; uma expressdo numé- 
rica que tem valor entre 0 e 39. 


colh Numero de coluna de grafico de alta resolucdo; uma expressdo numérica 
que pode ter valor entre 0 e 279. 


const Qualquer constante numérica ou cordao. 

Dn Um numero de drive de disco deve ser especificado como D1 ou D2. 

expr Um cordao numérico, constante relacional ou Booleana (apenas em 
Applesoft), variavel ou expressdo; qualquer combinacao destas. 

expr$ Qualquer constante cordao, varidvel ou expressdo. 

exprnm Qualquer constante numérica, varidvel ou expressdo. 

nomearg Qualquer nome de arquivo. 


linha Qualquer numero de linha de programa BASIC. 
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linha; Um dos varios nimeros de linha do programa BASIC. 

endmem Uma expressdo numérica, varidvel ou constante que se relaciona a um 
endereco de memoria. Os enderecos de memoria variam de —32767 
a 32767, ou em Applesoft, de 0 a 65535, onde —65535 é equivalente 
a 1, —65534 a 2 etc. 

posmem Uma posicao de memoria especificada por um inteiro constante entre 0 
e 65535 (decimal) ou $0 a $FFF (hexadecimal). As constantes hexa- 
decimais sao identificadas pelo sinal de dolar ($) a frente. 

mensagem Qualquer cordao de texto entre aspas. 

linha Numero de linha em grafico de baixa resolucdo; uma expressao numérica 
com valor entre 0 e 47. 

linhah Numero de linha em grafico de alta resolucdo; uma expressdo numérica 
com valor entre 0 e 191. 

Sn Numero do slot para entrada e saida; deve ser SO, S1, S2, S3, S4, S5, S6 
ou S7. 

var Em Integer BASIC, uma varidvel numérica ou cordado. Em Applesoft, 
qualquer variavel numérica, inteira ou cordao. 

varnm O nome de uma variave! numérica. 

var(sub) Em Integer BASIC, 0 nome de uma varidvel numérica subscrita. Em 
Applesoft, qualquer variavel inteira, numérica ou cordao. 

Vn Qualquer nimero de volume para identificacdo de disco (entre VO e 
V255). 

DECLARACOES 
APPEND 


Abre um arquivo (veja OPEN), e posiciona o apontador do arquivo no final. 


Formato: 


APPEND nomearg |, Dn][, Sn][, Va] 


Uma area de buffer de 595 bytes é alocada para o arquivo de texto especificado. Ele deve ser 
sequencial. O comando WRITE pode agora ser usado para guardar dados no disco, iniciando no 
primeiro byte nao usado. Isso sera imediatamente a frente do Ultimo caractere do arquivo, a menos 
que existam bytes nado usados no meio. 

Ocasionalmente, o APPEND pode nao comecar no primeiro byte nao usado do arquivo (em 
geral no fim). Em vez disso ele comeg¢a no inicio do arquivo (Horror!). Para certificar-se de que 
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TABELA 8.1. Determinacdes em Linguagem de Maquina para o APPEND. 


LINGUAGEM DE MAQUINA LINGUAGEM ASSEMBLER DO 6502 
nts | wwe [mmo 


a LDA $0 A rotina do Monitor em $FDED 


pde o caractere do registrador A 
($0 no caso) no dispositivo de 
saida corrente, o disco. Veja 
Apéndice D. 
isso nao ocorreu, seu programa deve sempre gravar uma indicagdo de fim de arquivo antes de fecha- 
lo. Uma pequena rotina em linguagem de maquina, descrita na Tabela 8.1 faz isso. Coloque com 
POKE as instrucdes em qualquer lugar da memoria onde existirem 5 bytes livres (posi¢des de 768 
até 772 sdo boas a menos que jd estejam sendo usados para outra coisa). Chame entdao a sub-rotina 
(CALL) antes de dar a instrucdo de fechar o arquivo. 

Se o arquivo nao existe no drive Dn do slot Sn, aparece a mensagem FILE NOT FOUND. 
Se o disco no drive Dn do slot Sn nao tem volume Vn, aparece a mensagem de erro VOLUME 
MISMATCH. VO serve para qualquer disco. Se o arquivo ja esta aberto, o APPEND o fecha e 
reabre (veja CLOSE). 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn ou Sn é omitido, o drive 
ou slot referenciado por Ultimo é usado. VO se aplica quando Vn estdé ausente. Também, n pode 
estar ausente; serdo usados DO, SO ou VO. 

O APPEND é um comando do DOS, requerendo PRINT e CTRL-D em modo programado. 

Nao pode ser usado em modo imediato. 



















JMP $FDED 





AUTO 


Gera numeracao automatica de linha em Integer BASIC. 


Formato: 


AUTO linha |, incremento | 


Os numeros de linhas s4o mostrados automaticamente a cada vez que se digita a tecla RETURN, 
iniciando com /inha, e incrementando cada vez de incremento, com a adocao de 10 se nao for 
especificado. Digite CTRL-X para limpar um nimero de linha automatico; a numera¢gao automa- 
tica continua a menos que se digite MAN na linha de texto (veja MAN). 

SO pode ser usado em modo imediato. 

Nao é disponivel em Applesoft. 


262 APPLE II 


BLOAD 
Pega um arquivo bindrio do disco e guarda em um setor especifico da memoria. 


Formato: 


BLOAD nomearg |, Aposmem]|, Dn] [, Sn] [, Va] 


Se 0 pardmetro A esta ausente, 0 arquivo especificado é colocado na memoria a partir da posicao 
de onde foi tirado na gravacao (veja BSAVE). Se o pardmetro A esta presente, 0 arquivo vai para 
a memoria para posmem. 

O BLOAD deve ser usado com cuidado. Aquilo que estiver na drea de memoria onde ele 
coloca 0 arquivo (como um programa, o Applesoft, DOS etc.) sera destruido. 

Se 0 arquivo nao existe no drive Dn no slot Sn, aparece a mensagem FILE NOT FOUND. 
Se o disco do drive Dn do slot Sn nao tiver o volume Vn, resulta no erro VOLUME MISMATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn ou Sn sdo omitidos, o drive 
ou slot referenciados por Ultimo sao assumidos. Usa-se VO se Vn esta ausente. 

Este € um comando do DOS, requer PRINT e CTRL-D em modo programado. 


BRUN 


Pegue um arquivo binadrio (que poderia ser um programa em linguagem de maquina), guarda-o 
numa posi¢do especifica de memoria, e executa um salto em linguagem de maquina (JMP no cédi- 
go assembler do 6502) para a posicao inicial de memoria. 


Formato: 
BRUN nomearg |, Aposmem||[, Dn] [, Sn] [, Va] 


Se o parametro A esta ausente, 0 arquivo especificado é colocado na memoria iniciando na posicao 
de onde ele foi tirado para gravar (veja BSAVE). Se o parametro A estiver presente, o arquivo é 
colocado a partir da posicao posmem. 

Um programa em linguagem de maquina pode operar bem em qualquer posicado de memoria. 
Cuidado com as instrucdes que sao dependentes de endereco antes de carregar o programa para 
uma area diferente de memoria. O BRUN destrdi tudo que estiver na drea de memoria onde ele 
coloca o arquivo; isso pode destruir o Applesoft ou o DOS no processo. 

Se oO arquivo nao existe no drive Dn, aparece a mensagem de erro FILE NOT FOUND. 
Se o disco no drive Dn e slot Sn nado tem o volume Vn, aparece a mensagem de erro VOLUME 
MISMATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn e Sn sao omitidos, o drive e 
slot referenciados por Ultimo sao usados. Usa-se VO quando Vn esta ausente. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 


BSAVE 


Cria um arquivo em disco e guarda uma area de memoria do Apple || nele, em binario. 
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Formato: 
BSAVE nomearq, Aposmem, Lcompr |, Dn|[,Sn][, Va] 


O pardmetro A especifica o endereco inicial da drea de memoria a ser gravada. O pardmetro L da 
Oo numero de bytes a guardar. compr deve ser um inteiro entre 0 e 32767 (decimal). Também pode 
ser em hexadecimal, quando fica precedido pelo sinal dolar ($). 

Se o disco no drive Dn do slot Sn nao tem o volume Vn, ocorre o erro VOLUME MIS- 
MATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn ou Sn é omitido assume-se 
o Ultimo drive ou slot que foi acessado. Usa-se VO se Vn esta ausente. Também o 7 pode estar 
ausente, e no caso é adotado DO, SO e VO. 

Este € um comando DOS, requer PRINT e CTRL-D quando usado em modo programado. 


CALL 


Pula para rotina em linguagem de maquina num endereco especifico. 


Formato: 
CALL endmem 


O CALL pode ser usado com sub-rotinas que se escrevem, Ou mesmo com sub-rotinas intrinsecas 
tais como as listadas no Apéndice D. 


CATALOG 


Mostra uma lista com todos os arquivos de um disco especificado. 


Formato: 
CATALOG [, Dn] [, Sn] 


O CATALOG primeiro imprime DISK VOLUME seguido pelo numero de volume do disco. Se o 
pardmetro Vn é incluido no comando CATALOG, é ignorado. 

A lista de arquivos do disco ¢ mostrada abaixo do numero de volume. Para cada arquivo, o 
CATALOG coloca um cédigo literal indicando o tipo de arquivo, o numero de setores requeridos 
para guardar o arquivo, e seu nome. Um asterisco aparece a esquerda do tipo de arquivo se ele esta 
bloqueado (veja LOCK). Os tipos de arquivo e seus codigos sao: 


Programa em Integer BASIC 
Programa em Applesoft 
Arquivo de texto 


D4 > 


Arquivo binario (linguagem de maquina) 
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Se o tamanho do arquivo excede 255 setores, o comprimento é dado como mddulo 255; ou 
seja, 0 para 256, 1 para 257 etc. 

Dn e Sn podem ser especificados em qualquer ordem. Se Dn ou Sn sao omitidos, o drive 
referenciado pela Ultima vez é usado. 

Este € um comando DOS, e requer PRINT e CTRL-D quando usado em modo programdo. 


CHAIN 


Carrega e roda um programa em Integer BASIC a partir do disco, sem limpar os valores de qualquer 
variavel ou arranjo. 


Formato: 
CHAIN nomearq |, Dn] [, Sn] [, Va] 


O comando CHAIN s6 pode ser usado em Integer BASIC, e apenas para carregar programas em 
Integer BASIC. 

Se o arquivo nado existe no drive Dn e slot Sn, aparece a mensagem de erro FILE NOT 
FOUND. Se o disco no drive Dn e slot Sn tiver volume Vn, aparece a mensagem de erro VOLUME 
MISMATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn ou Sn sao omitidos, o drive 
referenciado por Ultimo é usado. Usa-se VO para Vn ausente. Também n pode estar ausente, quan- 
do sao usados DO, SO e VO. 


CLEAR 


Esta declaracdo do Applesoft zera todas as varidveis numéricas e elementos de arranjos. Também 
atribui um valor nulo a varidveis corddo e elementos de arranjos tipo cordao. 


Formato: 
CLEAR 


Executar esta declaracdo equivale a desligar o Apple II, liga-lo de novo e carregar 0 programa na 
memoria. Um programa existente na memoria continuara rodando normalmente apds os CLEAR 
pois ele nado afeta a l6gica de programas. 

Em Integer BASIC, use CLR. 


CLR 


Este comando do Integer BASIC atribui valor 0 a varidveis e elementos de arranjos e valor nulo a 
variaveis tipo cordao. 
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Formato: 
CLR 


Ele também retira o dimensionamento de arranjos e corddes. Pode-se imprimir valores de arranjos 
apds a execucdo da declaracado CLS, desde que nao tenha sido atribuido valores a nenhuma variavel 
nesse (nterim. 

O CLR s6 pode ser usado em modo imediato. 

Em Applesoft, use CLEAR. 


CLOSE 


Desaloca o buffer usado pelo arquivo em disco especificado, e se a Ultima operacao com disco foi 
de gravacdo, guarda a informacao restante do buffer no disco. 


Formato: 
CLOSE [nomearg | 


Deve-se FECHAR todos os arquivos onde se gravou qualquer informacao por declarag¢do WRITE 
para que se tenha os dados de forma integral. Se nomearq esta presente, apenas aquele arquivo é 
fechado. Por auséncia de nomearq, fecham-se todos os arquivos (a excecao do arquivo EXEC, que 
esta controlando). 

Com DOS 3.2.1 e mais recentes, um arquivo sequencial ira ocasionalmente preencher um 
setor quando é fechado. Sob essas condicdes, um APPEND subsequente ira apontar o arquivo em 
seu inicio ao invés de seu fim. Para contornar isso, chame a sub-rotina em linguagem de maquina 
da Tabela 8.1 antes do comando CLOSE. Pode-se colocar a sub-rotina em qualquer lugar da 
memoria usando declaracdes POKE e ela usa cinco bytes (exemplo, posicdes de 768 a 772, a 
menos que ja esteja usada). 

Este €é um comando do DOS, e requer PRINT e CTRL-D em modo programado. 


COLOR= 


Gera cor para graficos de baixa resolucao. 


Formato: 
COLOR= exprnm 


Depois da Ultima declaragdo COLOR, toda declaragado PLOT, VLIN e HLIN ficara na cor especi- 
ficada. Os cddigos das cores sao listados na Tabela 8.2. O valor de exprnm deve estar compreen- 
dido entre 0 e 255; valores reais so convertidos para inteiros. Valores maiores que 15 repetem as 
cores mostradas na Tabela 8.2 (0, 16, 32 etc., dao preto etc.). 

Por auséncia, fica adotado COLOR=0. 
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TABELA 8.2. Cédigos de Cores em Baixa Resolucao. 


Preto Verde Escuro Marrom Verde 


Magenta Cinza Laranja Amarelo 
Azul Escuro Azul Médio Cinza Agua 


Purpura Azul Claro Rosa Branco 





A declaragao COLOR nao tem efeito quando se esta usando grafico em alta resolucdo. 
Dentro do modo texto, COLOR é um fator na determinacao de que caractere é colocado na tela 
pela declarag¢do PLOT. Para uma descricdo detalhada dessa propriedade, veja PLOT. 


CON 


Este comando do Integer BASIC devolve a execucdo de um programa na instrucdo seguinte a 
parada. 


Formato: 


CON 


O CON opera apdés a execucdo de uma parada com CTRL-C, e por vezes apds o RESET. Se nao 
houver interrupcao do programa, o CON simplesmente trava o sistema. Um programa nado pode 
continuar se foi interrompido por CTRL-C numa declaracao de entrada tipo INPUT. 

Se uma linha de programa foi inserida ou retirada, ou foi gerada uma mensagem de erro 
desde a interrupcao ocorreu, o CON poderd rodar normalmente, ou por vezes travar o sistema ou 
mesmo gerar mensagem de erro. 

O CON so pode ser usado em modo imediato. 

Para Applesoft, veja CONT. 


CONT 


Este comando do Applesoft devolve a execucao na préxima instru¢ao apos a parada. 


Formato: 


CONT 


O CONT opera apds a parada do programa com STOP, END ou CTRL-C. Se uma declaracao 
INPUT for interrompida com CTRL-C, o programa nao pode ser continuado. Se nado houver 
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interrupcao de programa, ou houve colocac¢déo ou aumento de uma linha de programa, ou se foi 
gerada uma mensagem de erro depois do programa ter sido interrompido, o CONT produzira a 
mensagem de erro ?CON’T CONTINUE ERROR. 

Para Integer BASIC, veja CON. 


DATA 


Cria uma lista de valores a serem usados pela declaragdo READ no Applesoft. 


Formato: 
DATA cont [, const... ] 


A declaragaéo DATA pode aparecer em qualquer lugar do programa, ela nao precisa ser executada 
para ser acessada por uma declaracéo READ. 

A declaragéo DATA especifica tanto valores numéricos quanto alfanuméricos (cordées). 
Constantes de corddes sdo geralmente colocadas entre colchetes; esses colchetes nao sao neces- 
sarios a menos que o corddo tenha espacos, virgulas ou dois pontos. Um sinal de colchete ndo pode 
ser usado como const; ele deve ser especificado usando a func¢a4o CHR$(34). 

Um ou mais parémetros const podem ser nulos, ou seja, apenas espacos em branco. Uma 
constante nula é colocada em zero em valores numéricos, e um cordao nulo (“” ”) na varidvel 
cordao. 

Nao seré dada mensagem de erro ao se tentar entrar DATA em modo imediato mas, porém 
os dados nao serao lidos dentro do programa com READ. 

Nao disponfvel em Integer BASIC. 


DEF FN 


A declaragao DEF FN permite funcdes de aplicacao especifica a ser definida e usada dentro de 
programas em Applesoft. 


Formato: 
DEF FNoavar (arg)=exprnm 


A variadvel real nvar identifica a funcdo, que é chamada posteriormente usando o nome FNovar. 

A declaracao funcao é definida por exprnm. arg 6 um nome de variavel ficticio que pode 
estar (e em geral esta presente em exprnm. Seu uso na declaragado DEF FN n€o tem efeito em qual- 
quer outra variavel com o mesmo nome em qualquer outro lugar do programa. 

Quando FNnvar é chamada, o valor da variavel ficticia é especificado por uma expressdo 
numérica, variavel ou constante. Os valores de todas as varidveis em exprnm devem ser definidos 
antes de FNnvar ser chamada. Veja também FN na secdo de funcGes deste capitulo. 

A declaragéo DEF FN inteira deve aparecer numa Unica linha de programa. Entretanto, 
uma funcao definida anteriormente pode ser incluida em exprnm, de forma que podem ser desen- 
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volvidas fung¢des da complexidade que se desejar. Entretanto, uma funcdo definida por usudrio 
nao pode referenciar a si propria, direta ou indiretamente (chamando uma funcao que, por sua 
vez, a chame). 

O nome de funcdo nvar pode ser usado novamente, e também ser redefinido para outra 
declaracao DEF FN que apareca depois, no mesmo programa. 

Nao disponivel em Integer BASIC. 

A declaracao de definicdo DEF FN é ilegal em modo imediato. Entretanto, uma fun¢ao que 
tenha sido definida apdos o Ultimo NEW, CLEAR ou LOAD pode ser referenciada em modo ime- 
diato. 


DEL 


Elimina as linhas de programa especificadas. 


Formato: 
DEL lin, ‘ ling 


Toda a linha de programa maior ou igual a /in, e menor ou igual a /iny é removida do programa 
presente na memoria. Se /in, nado existe, a eliminac¢do inicia na linha seguinte. Se /in, nado existe, 
ela termina na linha anterior. 

DEL deve ser seguido por dois nimeros de linha separados por virgula. Nenhum deles pode 
ser negativo, e o segundo deve ser maior ou igual ao primeiro. Se os numeros forem idénticos, uma 
linha (no maximo) sera eliminada. 

O DEL sé pode ser usado em modo imediato no Integer BASIC. 

Se DEL for usado em modo programado (possivel apenas em Applesoft), a eliminacdo ocorre 
€ O programa para. CONT nao continua a execucao neste caso. 


DELETE 


Retira um arquivo do disco. 


Formato: 
DELETE nomearqg [, Dn][, Sn] [, Vr] 


O arquivo especificado é removido do disco. 

Se ele ndo existir no drive Dn do slot Sn, aparecera a mensagem de erro FILE NOT FOUND. 
Se o disco no drive Dn no slot Sn nao tiver volume Vn, resultarad em erro VOLUME MISMATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se forem omitidos, o Ultimo drive 
referenciado sera usado. VO € usado quando Vn estiver ausente. Também 7 pode ser omitido, 
sendo entao usado DO, SO e VO. 

Este é um comando do DOS, e requer PRINT e CTRL-D em modo programado. 
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DIM 


Reserva espaco na memoria para um arranjo ou cordao. 
Devido as grandes diferencas entre o Integer BASIC e 0 Applesoft, o DIM é estudado abaixo 
em cada uma das versGes do Apple II. 


Formato em Integer BASIC: 
DIM var (sub) [, var (sub)... ] 


Em Integer BASIC s6 se pode definir arranjos de uma dimensao e variaveis tipo cordao simples. 

Quando se dimensiona um arranjo, 6 reservado espaco na memoria para o numero de elemen- 
tos mais 1. Eles sio numerados de 0 até sub. O elemento O de um arranjo é igual a variavel simples 
de mesmo nome (exemplo: A(O0)=A). 

A declaracdo DIM fornece o comprimento maximo de variaveis tipo cordao. Neste caso, sub 
é o comprimento do cordao. 

Todo sub subscrito deve estar entre 1 e 255 na declaracao DIM. Além disso, o maior dimen- 
sionamento permitido estd vinculado ao espaco de memoria existente. 

Aé se referenciar um arranjo usando uma subscri¢ao maior que aquela declarada em DIM, 
a mensagem *** RANGE ERR ocorre. Ao se tentar usar mais caracteres que o dimensionado em 
cordGes aparece a mensagem *** STRING ERR. 

O DIM nao atribui nenhum valor particular as variaveis do arranjo quando é executado. Por 
isso, deve-se inicializar qualquer arranjo (por exemplo, o zero) apds dimensiona-lo. Variaveis tipo 
cordao, por outro lado, sempre tém valor nulo apdés serem dimensionadas. 


Formato em Applesoft: 
DIM var (sub[, sub... ])[, var (sub[,sub... ])...] 


A declaracao DIM identifica arranjos com uma ou mais dimensdes, como segue: 


var (sub;) Arranjos de dimensao simples 
var (sub;,sub;) Arranjos de duas dimens6es 
var (sub;,subj,subz .. . ) Arranjos de dimensdes multiplas 


O Applesoft permite trés tipos de arranjos: inteiro, real e cordao. Cada elemento de um 
arranjo é de um tipo especificado pelo nome da variadvel usada para nome do arranjo. O numero de 
dimens6es do arranjo 6 dado pelo numero de subscritos usados na declaracdo DIM. Quando um 
arranjo é referenciado, cada subscrito deve estar dentro da faixa de 0 até sub, onde sub é o subs- 
crito correspondente a mesma varidvel na declaracdo DIM. 

O nu&mero de dimensdes em um arranjo é limitado pela quantidade de memoria disponivel. 
O n&mero mdximo de dimensdes de um arranjo pode ser até 88, e isso sO é possivel quando muitos 
dos subscritos forem 0. Um DIM com 89 ou mais subscritos, ou um que faca exceder as limitacdes 
de memoria produzira a mensagem de erro ?OUT OF MEMORY ERROR. 

Ao se tentar usar um elemento de arranjo com subscrito fora da faixa ou com numero de 
subscritos errado, a mensagem de erro 7BAD SUBSCRIPT ERROR aparece. 
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Se um elemento do arranjo é referenciado antes que o DIM correspondente seja executado, 
o Applesoft atribui o valor de 10 para cada subscrito. A partir daf o arranjo é tratado como se 
tivesse sido dimensionado em 10 para cada dimensdo. 

Um arranjo nunca pode ser dimensionado duas vezes, mesmo que um deles tenha sido di- 
mensionado por auséncia. Ao se tentar dimensionar um arranjo ja dimensionado, recebe-se a 
mensagem de erro ?REDIM’D ARRAY ERROR. 


DRAW 


Esta declaracdo do Applesoft desenha uma forma grafica de alta resolucdo na tela. 


Formato: 
DRAW exprnm [ AT colh, linh | 


A forma identificada pelo valor inteiro de exprnm é desenhada na cor determinada pela 
declarag¢d@o HCOLOR executada por Ultimo. A escala e rotagdo da forma deve ser indicada por 
comandos SCALE e ROT antes de se dar o DRAW. 

O desenho inicia no local dado pelo valor inteiro da expressao numérica co/h e /inh. Se nao 
for especificada a posi¢ao na declaracgdo DRAW, a forma inicia no Ultimo ponto indicado pelo 
ultimo comando DRAW, XDRAW ou HPLOT realizado. 

O numero da forma especificado (exprnm) deve estar entre 0 e o numero de formas da 
tabela (que ndo pode exceder a 255), inclusive. 

Evite usar DRAW se nao houver tabela de formas na memoria. O sistema pode travar, ou 
pode-se obter uma forma sem sentido na tela. Se o seu programa se estende até uma 4rea de 
memoria de alta resolucdo, ele também pode vir a ser destruido. 

Nao disponivel em Integer BASIC. 


DSP 


Apresenta a variacdo de valores de varidveis na execucdo de um programa em Integer BASIC. 


Formato: 
DSP var 


O valor da variavel var e o numero de linha corrente sdo mostrados sempre que o valor dessa varia- 
vel é alterado. Essa mostragem pode interagir com os dados safdos de seu programa, tornando um 
ou ambos ininteligiveis. O RUN cancela todos os DSP dados. Use CON ou GOTO ao depurar 
programas com o DSP em modo imediato. 

Para desligar o DSP, use NO DSP. 

Nao disponivel em Applesoft. 


COMPENDIO DE DECLARACOES DO BASIC 271 


END 


Causa parada no programa. 


Formato: 


END 


Nao é colocada nenhuma mensagem. Em Integer BASIC, o END deve ser a Ultima instrucdo exe- 
cutada ou a mensagem *** NO END ERR aparece. O END 6 opcional em Applesoft. 
Nao pode ser usado em modo imediato no Integer BASIC. 


EXEC 


Executa um arquivo de texto em disco como se cada caractere fosse digitado no teclado. 


Formato: 
EXEC nomearg |, Rn][, Dn] [, Sn] [, Va] 


Um arquivo de texto a ser usado com EXEC deve conter combinacao de comandos BASIC, co- 
mandos DOS e linhas de programa. Quando EXEC é executado, a primeira linha do arquivo espe- 
cificado é lida do disco. Se for comando, ele sera executado imediatamente; se for linha de pro- 
grama, ira para a memoria, exatamente como se tivesse sido entrado pelo teclado. 

Um arquivo EXEC pode ser usado para entrar um programa inteiro, lista-lo, executd-lo, 
guarda-lo no disco, trazé-lo de volta, e qualquer outra coisa que se pode fazer a partir do teclado. 
Pode-se até usar um arquivo EXEC para criar e executar outro arquivo EXEC. 

O pardmetro R, se presente, especifica qual campo do arquivo sera executado primeiro. 
Quando usado com o EXEC, o pardmetro R sempre conta a partir do inicio do arquivo: o primeiro 
Campo do arquivo é o campo O, o segundo é o 1 etc. O nimero que segue o R deve ser uma cons- 
tante inteira entre 0 e 32767. Se Rn especificar o Ultimo campo apds o fim de arquivo, nada 
acontece. Se ele especifica dois ou mais campos depois do fim de arquivo, aparece a mensagem 
END OF DATA. 

Se uma declaracdo INPUT é executada enquanto o arquivo EXEC esta aberto, a resposta 
é tirada do arquivo EXEC. 

Quando a dltima linha de um arquivo foi executada, o arquivo EXEC fecha a si mesmo 
(veja CLOSE). Quando um comando EXEC é encontrado num arquivo de controle EXEC, o 
arquivo original 6 fechado e qualquer outro comando dele é ignorado; 0 novo arquivo EXEC é 
aberto e passa a operar normalmente. 

Se o arquivo ndo existe no drive Dn do slot Sn, aparece a mensagem FILE NOT FOUND 
de erro. Se o disco no drive Dn do slot Sn nado tem volume Vn, aparece um erro VOLUME MIS- 
MATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn, e Sn sao omitidos, o drive 
referenciado por ultimo é adotado. VO é usado por auséncia de Vn. Também 7 pode estar ausente, 
quando se adota DO, SO e VO. 

Este € um comando do DOS, requer PRINT e CTRL-D em modo programado. 
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FLASH 


Esta declaracdo do Applesoft faz os caracteres do video piscarem. 


Formato: 
FLASH 


Toda a saida por PRINT subseqiente ficaré sendo mostrada alternativamente em branco-sobre- 
preto e preto-sobre-branco. As mensagens de erro também sao dadas nessa forma. Entretanto, os 
caracteres mostrados na tela devidos a INPUT nao sao afetados, assim como todos os caracteres 
anteriores ao FLASH. 

O FLASH opera alterando um pouco o cédigo ASCII padrao. Por isso, todos os caracteres 
mandados para o disco em modo flash serdo transferidos com cédigos incorretos. Ao serem lidos 
de volta, aparecerdo caracteres errados. 

Nao disponivel em Integer BASIC. 


FN 


Mostrado na parte de funcdes neste capitulo. Veja também DEF FN. 


FOR 


Inicia um /oop que repete uma série de instrucdes até que uma variavel de incremento automatico 
atinja um determinado valor. 


Formato: 
FOR varnm=exprnm, TO exprnm, [STEP exprnm; | 


Quando o FOR é executado pela primeira vez, 6 dado o valor exprnm, 4a variavel varnm. As decla- 
ragdes seguintes ao FOR sao executadas até que uma declaracaéo NEXT apareca. O valor de varnm 
é entdo incrementado de exprnm; (ou 1 se STEP nao esta presente). Em seguida, o novo valor de 
varnm @ comparado com o valor de exprnm3. Se o sinal é positivo e o novo valor de varnm é me- 
nor ou igual a exprnm,, a execucao volta para a declaracao seguinte ao FOR. A mesma coisa acon- 
tece se o sinal de exprnm; é negativo e o novo valor de varnm é maior ou igual a exprnm,. Por 
outro lado, a execu¢ado continua com a declaracdo seguinte ao NEXT se varnm é maior que 
exprnm, (exprnm3 positivo) ou menor ou igual a exprnm, (exprnm3 negativo). Devido a com- 
paracao ocorrer depois de incrementar varnm, as instrucdes entre o FOR e o NEXT sao executadas 
em, pelo menos, uma vez. 

Em Integer BASIC, varnm deve ser uma variavel inteira. Em Applesoft, varnm deve ser uma 
variavel real. Ela nunca pode ser do tipo cordao. 

Os valores de inicio, fim e incremento sdo determinados por exprnm,, exprnm, e exprnm3; 
apenas uma vez, na primeira execucao da declaracdo FOR. Se esses valores sdo trocados dentro do 
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loop, eles nao afetardo o /oop. Pode-se trocar o valor de varnm dentro do /oop. |sso pode fazer 
com que se termine o FOR-NEXT antes que o valor final seja encontrado: coloque em varnm o 
valor final (de exprnm,), e no caso seguinte do /oop ele sera terminado. Nao inicie um /oop 
dentro de uma sub-rotina finalizando em outra. 

Os /oops FOR-NEXT podem ser aninhados. Cada um dos /oops no caso devem ter um 
varnm diferente. Cada /oop aninhado deve estar totalmente contido no outro mais externo, os 
loops nao podem terminar no mesmo ponto. O Integer BASIC permite 16 niveis de /oop para o 
FOR-NEXT, 0 Applesoft permite apenas 10. 

O FOR pode ser usado em modo imediato apenas em Applesoft. O /oop inteiro deve ser 
entrado na mesma linha. Se o NEXT nao estiver presente, o /oop sO sera executado uma vez. 


FP 


Coloca o Apple || em Applesoft. 


Formato: 
FP[,Dn][,Sn][, Va] 


A fonte do Applesoft depende de que tipo de Apple II se tem, e de que opcionais estao insta- 
lados: 


1. Com Apple II Plus a linguagem esta em ROM (memoria so de leitura), nado importa que 
tipos de opcionais existem. 


2. Se tiver o cartaéo Applesoft firmware instalado, o FP obtém a linguagem a partir dele, 
nao importando as chaves do cartado. 


3. Como Apple |! Language System instalado, o FP pega o Applesoft dele. 


4. Em qualquer outro Apple II, o FP procura o Applesoft no disco especificado (ou cor- 
rente). Se ele nao existe la, a mensagem LANGUAGE NOT AVAILABLE aparece. 


O FP zera qualquer programa BASIC presente na memoria. 

Se o arquivo nao existe no drive Dn do slot Sn, a mensagem de erro FILE NOT FOUND 
aparece. Se o disco do drive Dn, slot Sn nao tem volume Vn, aparece o erro VOLUME MISMATCH. 

Dn, Sn e Vn podem aparecer em qualquer ordem. Se Dn e Sn sao omitidos, o drive referen- 
ciado por Ultimo é adotado. VO é usado por auséncia de Vn. Também 7 pode estar ausente, e DO, 
SO e VO sao usados. 

Uso apenas em modo imediato. 


GET 


Esta declaracdo do Applesoft aceita um caractere Unico do teclado sem mostrar na tela. 
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Formato: 
GET var 


A execuc¢ao para até que uma tecla seja acionada. Quando var é uma varidvel cordao, o caractere 
é associado a varidvel. Se CTRL-@ é entrado, fica atribufdo o cordao nulo 4a variavel. 

O GET nao tem uso freqlente com valores numéricos para varidveis. Quando é usado, per- 
mite a entrada de um digito de 0 a 9, associando o valor a varidvel. Entrando-se o sinal mais, me- 
nos, virgula, dois pontos, CTRL-E, espaco, E, ou ponto, o valor da variavel fica sendo zero. Entran- 
do qualquer caractere diferente desses acima, resulta a mensagem de erro ?SYNTAX ERROR, 
e€ O programa para. 

O GET ndo pode ser usado em modo imediato. 

Nao disponivel em Integer BASIC. 


GOSUB 


Faz 0 programa pular para a linha indicada. Quando é executada uma instrucdo RETURN, o pro- 
grama pula de volta para a instrucao imediatamente seguinte ao GOSUB. 


Formato Geral: 
GOSUB /in 


A declarag¢ao GOSUB chama uma sub-rotina. O ponto de entrada da sub-rotina deve ser na linha 
numero /in. Esse ponto de entrada deve ser o inicio ldgico de uma sub-rotina. Ou seja, uma linha 
que contenha uma declarag¢ado que é executada primeiro. O ponto de entrada da sub-rotina nao 
precisa necessariamente ser o seu Menor numero de linha. 

Apos a completa execucao da sub-rotina, o programa volta a linha seguinte ao GOSUB. A 
sub-rotina usa uma declaragado RETURN para informar que o programa deve voltar. 

Um GOSUB pode ocorrer em qualquer ponto do programa; portanto, uma sub-rotina pode 
ser chamada de qualquer ponto do programa. 

Sub-rotinas podem ser aninhadas; isto é, podem ser chamadas de dentro de outras sub- 
rotinas. So permitidos vinte e cinco niveis de aninhamento no Applesoft, ou seja, podem ser exe- 
cutadas vinte e quatro declaracdes GOSUB antes da primeira declaracdo RETURN. O limite em 
Integer BASIC sdo 16 niveis. 

Normalmente deve-se sair de uma sub-rotina com uma declaracaéo RETURN, e nao GOTO. 
Porém pode-se usar GOTO para sair da sub-rotina se antes for executada uma declaracado POP. 

Nao pode ser usada em modo imediato no Integer BASIC. 


Formato Adicional no Integer BASIC: 
GOSUB exprnm 


Em Integer BASIC, uma expressao numérica pode ser colocada no lugar do numero de linha. Se o 
calculo de exprnm nao resultar num numero de linha existente, aparece a mensagem de erro 


COMPENDIO DE DECLARACOES DO BASIC 275 


*** BAD BRANCH ERR. Este formato do GOSUB permite simular a instrugéo ON GOSUB, que 
nao é disponivel em Integer BASIC. 


GOTO 


Salto incondicional do programa para a linha indicada. 


Formato Geral: 


GOTO /in 


A execucao do programa continua a partir da linha indicada. Se ela nado existe, aparece a men- 
sagem ?UNDEF’D STATEMENT ERROR no Applesoft, e a mensagem *** BAD BRANCH ERR 
no Integer BASIC. 


Formato Adicional no Integer BASIC: 
GOTO exprnm 


Em Integer BASIC, é permitido colocar uma expressao numérica no lugar do numero de linhas. Se 
o numero de linhas calculado nao existir, a mensagem *** BAD BRANCH ERR aparece. Essa 
forma do GOTO permite simular a declaragdo ON GOTO, nao disponivel em Integer BASIC. 


GR 


Converte a tela para grafico de baixa resolucéo (40 X 40), deixando quatro linhas para texto na 
parte baixa da tela. 


Formato: 


GR 


A porcao grafica da tela 6 colocada em preto, o cursor é posicionado na janela de texto, e COLOR 
é posto em O (preto). 

Se executado enquanto HGR esta em atividade, o GR se comporta normalmente. Entre- 
tanto, se HGR2 estiver em processo, o sistema dara acesso a pagina 2 de texto e graficos em baixa 
resolucao. Isso pode ser confuso, porque a tela ficara cheia de bobagem e nada que for digitado 
aparecera na tela. Para voltar ao modo normal, digite TEXT. Use sempre TEXT nos programas, ao 
passar de HGR2 para GR. 

Pode-se pular para a forma de tela cheia (40 X 48), em grafico de baixa resolucado, com a 
declaracao POKE —16302,0 apds executar GR. Qualquer coisa digitada apés isso no modo ime- 
diato sera colocada na tela como pontos coloridos nas quatro Ultimas linhas da tela, porém a 
execucao serd normal. POKE —16302,0, devolve a janela de texto. 
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HCOLOR= 


Esta declaracdo do Applesoft fornece a cor para desenho em modo grafico em alta resolucao. 


Formato: 
HCOLOR= exprnm 


Até a declaracdo HCOLOR seguinte, todas as declaragdes HPLOT e DRAW serdo executadas na 
cor especificada. Os coddigos de cores sao listados na Tabela 8.3. O valor de exprnm deve estar na 
faixa entre 0 e 7. Valores fora dessa faixa produzem uma mensagem ?ILLEGAL QUANTITY 
ERROR. Um desenho executado antes da primeira determinacado HCOLOR sera feito numa cor 
indefinida. 

O HCOLOR nfo afeta graficos em baixa resolucdo. Uma declaracdo HCOLOR executada 
quando o Apple I! ndo esta em modo grafico de alta resolucdo nao afeta a cor do desenho seguinte 
em alta resolucao. 


Nao disponivel em Integer BASIC. 


HGR 


Esta declaracdo do Applesoft converte a tela em modo grafico de alta resolucao (260 X 160), com 
uma janela de texto de quatro linhas na parte de baixo da tela. 
Formato: 

HGR 


E mostrada a pagina 1 de alta resolucdo. A memoria da tela de baixa resolucdo (texto) nado é afe- 
tada, porém apenas as quatro Ultimas linhas ficam visiveis. O cursor nado se move para essa janela. 
Nao se pode ver o cursor até que se tenha digitado varias linhas apdés executar o HGR. A porcao 
grafica da tela 6 colocada em preto. HCOLOR no é afetado com este comando. 


TABELA 8.3. Céddigos de Cores em Alta Resolucao. 


Preto Preto 


Verde Laranja* 


Violeta* Azul* 


Branco Branco 


* Depende dos controles da TV. 
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Pode-se ter toda a tela (280 X 192) em forma de alta resolucdo com a declaragéo POKE 
16302,0, apds executar HGR. Qualquer comando dado no modo imediato depois disso nao sera 
visto na tela, porém sera executado de acordo. POKE —16301,0 devolve a janela de texto. 

Em sistemas do Apple I! com menos de 32K bytes de memoria, nado se pode usar HGR e o 
DOS ao mesmo tempo desde que eles ocuparao necessariamente a mesma drea de memoria. 

Além disso, o interpretador Applesoft em disco ou cassette ocupa parte da pagina grafica 1 
de alta resolucao. Por isso ndo se pode usar HGR com Applesoft em disco ou cassette. 

Mesmo com Applesoft em firmware, se 0 programa é muito longo, ele pode entrar na area de 
pagina grafica de alta resolucdo 1. Pode-se precaver sobre isso com o comando HIMEM: 8192 
que mantém o programa fora da area grafica 1. 

Nao disponivel em Integer BASIC. 


HGR2 


Converte a tela inteira para modo grafico de alta resolucdo (280 X 192). E mostrada a pagina 2 
de grafico em alta resolucao. 


Formato: 


HGR2 


A memoria de tela em baixa resolucdo (texto) nao é afetada. Entretanto nado se consegue ver o 
que é digitado, apesar de ser executado normalmente. A tela colocada em preto. O HCOLOR 
nao é afetado por este comando. 

A pagina grafica 2 nao é disponivel se o sistema tem menos de 24K de memoria. Em sis- 
temas com 24K, coloque HIMEM: em 16384 antes de usar HGR2 para proteger o programa e as 
variaveis dos graficos, e vice-versa. 

Nao se pode usar HGR2 e o DOS de forma simultanea a menos que o sistema tenha 36K 
de meméria ou mais. Isso quer dizer que sao necessdrios pelo menos 36K para ter o HGR2 junto 
com o Applesoft em disco. 

Nao tente gerar uma janela de texto com POKE —16301,0. Isso vai mostrar a pagina gra- 
fica 2 de baixa resolucao enquanto os comandos digitados vao para a pagina 1 tornando-se invisi- 
veis (embora sejam executados corretamente). 

Nao disponivel em Integer BASIC. 


HIMEM: 


Gera o limite superior de memoria disponivel para programa em BASIC, incluindo 4rea de varidveis. 


Formato: 


HIMEM: exprnm 


HIMEM: determina a posi¢ado mais alta de memoria de leitura e gravacdo (RAM) disponivel para o 
programa BASIC. O sistema operacional em disco (DOS) sempre reside acima do HIMEM: se esta 
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presente. Com a declaragdo HIMEM: pode-se reservar espaco para sub-rotinas em linguagem de 
maquina e tabelas de forma grdfica de alta resoluc¢do. Também se pode proteger a drea de RAM 
reservada para tela grafica de alta resolucao. 

HIMEM: primeiramente 6 preenchido com a posicdo de memoria mais alta do Apple I! (por 
exemplo, 49151 em sistemas de 48K). O DOS reside na parte mais alta da memoria, de forma que 
ele ajusta o HIMEM: aproximadamente 10.800 bytes abaixo quando é carregado. Cada arquivo 
de buffer adicional que é carregado via MAXFILES abaixa o HIMEM: outros 595 bytes. Se o pro- 
grama em Applesoft usa corddes, seus valores sao guardados iniciando na posicao resultante de 
HIMEM:, trabalhando de cima para baixo. Consulte o mapa de memoria no Apéndice G. 

O valor de exprnm deve estar na faixa entre —65535 até 65535 (—32767 até 32767 em 
Integer BASIC) ou ocorre uma mensagem de erro. 

Ndo se deve colocar o HIMEM: indicando posicao acima da maior posicao de memoria dis- 
ponivel, porque nesse caso se corre o risco de ter armazenamento de varidveis em posicdes de 
memoria nao existente. 

Pode-se ver o valor corrente de HIMEM: usando as instrucdes apropriadas, como listado 
abaixo: 


PRINT PEEK(116) *« 256 + PEEK (115) para Applesoft 
PRINT PEEK(77) * 256 X PEEK (76) para Integer BASIC 


HIMEM: nao é afetado por NEW, RUN ou CLEAR. 

Se for dado HIMEM: menor que LOMEM: ou n@o se deixar espaco suficiente para o progra- 
ma, ocorre uma mensagem de erro. 

S6 pode ser usado em modo imediato no Integer BASIC. 


HLIN 


Desenha uma linha horizontal na tela dentro do modo grafico em baixa resolucao. 


Formato: 
HLIN co/,, co/, AT lin 


A linha é desenhada de co/, até co/, na linha especificada. A cor é determinada pela Ultima decla- 
racdo COLOR executada. Se a tela estiver em modo texto, ou se a janela de texto estiver presente, 
e /in for maior que 39, HLIN desenhard uma linha de caracteres na tela, no lugar referente a janela 
de texto, onde os pontos graficos deveriam ser colocados. Os caracteres usados sao determinados 
pela Ultima declaracdo COLOR executada; veja a Tabela 8.5 (perto da declaracao PLOT neste 
capitulo) para detalhes. 

Em Integer BASIC, co/, deve ser menor ou igual a co/, ou a mensagem *** RANGE ERR 
aparecera. 


COMPENDIO DE DECLARACOES DO BASIC 279 


HOME 


Esta declaracdo do Applesoft limpa a tela e posiciona o cursor no canto superior esquerdo da 
janela de texto. 


Formato: 
HOME 


Em Integer BASIC, use CALL-936. 


HPLOT 


Esta declaracdo do Applesoft coloca um ponto ou desenha uma linha colorida na tela grafica de 
alta resolucao. 


Formato: 


HPLOT colh, linh 
HPLO TO colh, linh 
HPLOT co/h,, /inh, TO colh,, linh, [TO colh3, linh; ... | 


A primeira forma do comando coloca um ponto colorido na tela e na posicdo especificada. A cor 
do ponto é determinada pela Ultima declaracdo COLOR executada. 

A segunda forma do comando desenha uma linha colorida a partir do Gltimo ponto colo- 
cado até as coordenadas co/h e /inh. Se nado houve ainda nenhum desenho desde que foi dado o 
comando HGR ou HGR2, nada sera desenhado. A cor da linha é dada pela Ultima declaracao 
HCOLOR executada. 

A terceira forma do comando também desenha uma linha colorida. Com o Applesoft em 
firmware, a linha pode ter mais de um segmento. Primeiro é desenhado o segmento de colh, e 
linh, até col, e linh3. A cor da linha (todos os segmentos) é dada pela Ultima declaracao COLOR 
executada. 

Nao sao permitidas coordenadas adicionais em Applesoft em disco ou cassette. Quando 
presente em um programa Applesoft em firmware, o segundo segmento é desenhado a partir de 
col, e linh, até colh; e linh3 etc. Pode haver qualquer numero de pares de coordenadas desde 
que eles caibam em uma linha de programa. 

Qualquer porcdo de uma linha ou pontos que cairem na janela de texto nao serao visiveis. 
Entretanto, se for mudado para formato de grafico total como o comando POKE —16302,0, 
qualquer linha ou ponto desenhado na janela de texto se tornara visfvel. 

Deve-se sempre executar uma declaracdo HGR ou HGR2 antes de um HPLOT. De outra 
forma, pode-se destruir programas ou variaveis. 

Nao disponivel em Integer BASIC. 
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HTAB 


Esta declarag¢do em Applesoft posiciona o cursor numa coluna especificada na linha corrente. 


Formato: 
HTAB co/ 


O cursor se move para a direita ou esquerda para a coluna especificada pelo valor de co/, sem 
limpar qualquer caractere na tela. As colunas sdo numeradas de 1 a 40 (esquerda para a direita). 
Em Integer BASIC, usa a declaracdo TAB. 


IF-THEN 


Execu¢do condicional de instru¢do ou instrugdes pelo programa. As regras para Integer BASIC 
e Applesoft sdo vistas em separado. 


Formato em Integer BASIC: 


IF expressa@o THEN declaracao 


IF expressao THEN [GOTO] /inha 


Na primeira forma da declaragdo IF-THEN, a expressao especifica uma condicao que, se verda- 
deira, causa a execucao da declaracdo seguinte ao THEN. Se a condicao é falsa, 6 executada a 
declaragdéo em seguida ao IF-THEN; a declaracao seguinte ao THEN nao é executada neste caso. 

No segundo formato do iF-THEN (formato de salto condicional), a expressdo especifica 
uma condi¢ao que, sendo verdadeira, causa o salto do programa para o numero de linha indicado. 

As expressdes relacionais sao as mais frequentemente usadas em IF-THEN. Valores tipo 
corddo sO podem ser comparados como iguais ou diferentes em Integer BASIC. 

expr também pode ser uma expressdo numérica. Nesse caso, expr é considerada verdadeira 
se for um valor diferente de zero. 

A expressdo IF-THEN nao pode ser uma expressdo cordao (ou seja, qualquer coisa que 
calcule uma variavel cordao) em Integer BASIC. 


Formato do Applesoft: 


IF expr THEN declaracao | : declaracao.. . | 
~ THEN 
IF expr GOTO linha 
THEN GOTO 


No primeiro formato da declaracdo IF-THEN, a expressdo especifica uma condicdo que, se verda- 
deira, causa toda a declaragao que segue THEN na mesma linha de programa a ser executada. Se 
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a condicdo é falsa, o controle passa para a primeira dec/aracao da linha de programa que segue 
e nenhuma declara¢ao depois do THEN é executada. 

No segundo formato (formato de salto condicional), o programa pula para a linha numero 
linha se a condicao é verdadeira. De outra forma a execucaéo continua com a primeira declaracao 
da primeira linha de programa que segue o IF-THEN. 

Se um salto incondicional for uma das varias declaracdes que segquem o THEN, entdo ele 
deve ser a Ultima declaracdo da linha, e deve ter o formato GOTO /inha. Se um salto incondicional 
nao for a ditima declaracdo da linha, as declaracdes que 0 seguem nunca serdo executadas. 

O tipo mais comum de expressdo usado em IF-THEN 6 o relacional. Se expressdes tipo 
corddo sdéo comparadas usando operadores relacionais, os codigos ASCII (listados no Apéndice |!) 
dos caracteres envolvidos determinam os valores relativos dos corddes. SAdo comparados caractere 
por caractere até que uma diferenca ocorra. Entaéo o cordao com cédigo ASCII maior naquela 
posi¢ao sera considerado maior. Se nao ocorrer diferenca, 0 cordao mais longo sera o maior. 

A expressdo também pode ser numérica. Se o valor da expressao nao é zero, a condicao é 
considerada verdadeira. Se o valor da expressdo é zero (falso), a execu¢ao continua a partir da 
primeira linha de programa a seguir. 

Em Applesoft, expr também pode ser uma expressdo tipo cordao. Entretanto, a execucdo 
de duas ou trés declaracdes no decorrer de um programa gera a mensagem ?FORMULA TOO 
COMPLEX ERROR. 

O Applesoft tem problemas se o Ultimo caractere ndo-espaco que precede o THEN é a 
letra A. O A combinado com o T forma a palavra reservada AT. Para evitar esse problema pode-se 
fechar com parénteses toda a expressao, incluindo o A. 

Se um loop FOR-NEXT vier em seguida ao THEN, ele deve estar inteiramente contido 
dentro da linha IF-THEN. Outros IF-THEN podem vir a seguir ao THEN, desde que estejam 
completamente contidos dentro da linha IF-THEN original. Entretanto, uma expressdo Booleana 
ganha de IF-THEN aninhados no aspecto de clareza. Por exemplo, as duas declaracdes abaixo sao 
equivalentes, mas a segunda é mais facil de ser entendida. 


10 IF A$ = ’X” THEN IF B = 2 THEN IF C>D THEN 50 
10 IF A$ = “X” AND B = 2 AND C>D THEN 50 


IN# 


Selecione o slot periférico de onde as entradas subseqtientes serao aceitas. 


Formato: 
IN# s/ot 


Todas as declaracSes que seguirem procuracao dados no periférico do slot determinado. s/ot 
deve ser um valor inteiro entre 0 e 7. Note que slot 0 nado é um dispositivo periférico; IN#0O 
especifica o teclado como dispositivo de entrada. Se nao existir periférico acoplado ao slot especi- 
ficado, o sistema ficara bloqueado até o acionamento de RESET. 

Sempre que o DOS estiver presente na memoria do Apple II, IN# sera considerado um 
comando do DOS, requerendo PRINT e CTRL-D em modo programado. 
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INIT 


Inicializa um disco. 


Formato: 
INIT nomearq [, Dn] [, Sn] [, Va] 


O programa presente na memoria 6 guardado no disco sob o nome de arquivo dado. Esse pro- 
grama se torna o programa de saudacdo, e roda automaticamente sempre que o disco é carregado. 
Ao disco é associado o numero de volume com que ele é inicializado; se nao é informado nenhum 
numero de volume, associa-se ao disco o numero de volume 254. 

Se 0 arquivo nao existe no drive Dn do slot Sn, aparece a mensagem de erro FILE NOT 
FOUND. 

Dn, Sn e Vn podem ser dados em qualquer ordem. Se Dn e Sn sao omitidos, o drive aces- 
sado por ultimo é usado. Também 7 pode ser ausente; DO ou SO sao usados. 

O INIT s6 pode ser usado em modo imediato. 


INPUT 


Aceita caracteres entrados a partir do teclado ou outro dispositivo de entrada, calcula e associa o 
valor ou valores com a variavel ou variaveis. 


Formato em Integer BASIC: 
INPUT [“requisicao”, | var |, var... ] 


O INPUT no Integer BASIC aceita valores em qualquer combinacao entre varidveis inteiras e 
cordoes. Se a primeira variavel é um inteiro, entéo aparece um ponto de interrogacao na posicdo 
atual do cursor como uma indicacdo para entrada. O Integer BASIC nao coloca interrogacdo se 
a primeira variavel a ser entrada é um cordao. 

A requisic¢ao opcional é uma constante tipo corddo. Se presente, é mostrada antes da pri- 
meira variavel a ser entrada; ela ndo se repete a cada variavel da lista. Aparece um ponto de inter- 
rogacdo a frente da requisicao se a primeira variavel da lista 6 um inteiro. SO é mostrada a requi- 
sicdo se a primeira varidvel a entrar é um corddo. Veja que a requisicao é sequida de virgula na 
declaragado INPUT. A requisicao nado pode ser uma variavel cordao ou uma expressdao tipo cordao. 

Quando uma Unica declaragao INPUT chama mais de uma variavel de forma sucessiva, pode- 
se entrar cada uma delas numa linha separada; separando cada valor com a tecla RETURN. O 
Integer BASIC mostra um ponto de interrogacado (?) a cada linha, pedindo outra entrada. Opcio- 
nalmente, pode-se entrar mais de um valor inteiro na mesma linha; separando os valores com 
virgula. 

Entradas numéricas devem conter apenas caracteres validos como numéricos. Os digitos de 
0 a 9, espaco e sinais de mais e menos. Obtém-se uma mensagem de erro ao se acionar RETURN 
sem entrada de nenhum valor numérico. 

Deve-se digitar cada variavel tipo cordado numa linha separada. Todos os caracteres (exceto 
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CTRL-C, CTRL-M, CTRL-H, CTRL-U e CTRL-X) digitados antes de se acionar RETURN s§o aceitos 
e associados a variavel cordao. O corddo nulo (“’ ”’ ) é associado a variavel no caso de acionamento 
simples da tecla RETURN quando uma variadvel corddo é esperada. Se forem digitados caracteres 
inaceitaveis (ou seja, letras em valores numéricos) a mensagem de adverténcia *** SYNTAX ERR 
e RETYPE LINE aparece. Deve-se reentrar todos os valores digitados na linha nao aceita. 

Nao pode ser usado em modo imediato. 


Formato no Applesoft: 
INPUT [requisicao; | var|,var... | 


O INPUT pode requisitar qualquer combinacdo de valores numéricos e corddes. Um ponto de 
interrogag¢do € normalmente mostrado como indicacdo de inicio de digitacao, no ponto onde esta 
o cursor. O Applesoft suspende a interrogacdo se a requisicao opcional estiver presente. 

A requisicao é uma constante tipo corddo. Se presente, ela 6 mostrada antes da variavel ser 
digitada, nao sendo repetida para as digitagdes das variaveis da lista. Nao é colocado o ponto de 
interrogacado apdés a requisi¢ao. Note como a requisicao é seguida de ponto-e-virgula na decla- 
racdo INPUT. 

De forma geral, quando uma declaracaéo INPUT simples chama mais de um valor, pode-se 
entrar cada um em uma linha separada; terminando cada digitag¢do com a tecla RETURN. O Apple- 
soft mostra interrogacdo dupla (??) para cada valor requerido. Opcionalmente, pode-se entrar 
mais de um valor numa Unica linha; separando-os com virgula. 

Se forem digitados caracteres inaceitaveis (exemplo: letras em valores numéricos) aparece 
uma mensagem de adverténcia e deve-se redigitar toda a linha. O Applesoft manda a mensagem 
REENTER e reexecuta a declaracdo INPUT a partir de seu inicio. A interrogacdo ou a requisicao 
é impressa e deve-se redigitar todos os valores do INPUT. 

Entradas numéricas devem consistir apenas de caracteres numéricos. Se apenas for acionada 
a tecla RETURN, quando é esperado um valor numérico, aparece a mensagem de erro e a linha 
deve ser redigitada. Os digitos de 0 a 9, espaco e os sinais de mais e menos sao aceitos como valores 
numéricos. O Applesoft também aceita o ponto decimal, um sinal adicional de mais ou menos e a 
letra E para a entrada de numeros reais em notacao cientifica. 

Em Applesoft, se 0 primeiro caractere diferente de espaco numa entrada de cordao é aspas, 
todos os caracteres (incluindo virgulas e dois pontos) até as proéximas aspas ou RETURN sdo 
atribufdos a variavel. Se a entrada nao inicia com aspas, todos os caracteres (incluindo aspas) até 
a proxima virgula, dois pontos ou RETURN sao atribu/fdos a varidvel. Se dois ou mais cordGes sao 
requisitados pela declaracdo INPUT, eles devem ser separados por virgulas. 

Se for acionada apenas a tecla RETURN quando é esperado um cordao, 0 cordao nulo ( 
é associado a variavel. 

Em Applesoft, todos os caracteres apds dois pontos em INPUT sao ignorados a menos que 
a digitacao inicie com aspas. 

INPUT nao pode ser usado em modo imediato. 


4a 7” 


INT 


Coloca o Apple II em Integer BASIC. 
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Formato: 


INT 


Qualquer programa presente na memoria é zerado. Se o Integer BASIC nao esta presente (por 
exemplo, num Apple || Plus sem o Language Card), a mensagem LANGUAGE NOT AVAILABLE 
aparece. 

Usado apenas em modo imediato. 


INVERSE 


Esta declaracdo do Applesoft liga o modo video inverso (também chamado video reverso). 


Formato: 
INVERSE 


Todas as saidas subseqUuentes, dadas com declaracao PRINT aparecerdo em caracteres preto-no- 
branco. As mensagens de erro também sao afetadas. Entretanto, os caracteres mostrados na tela 
devido a declaracdes INPUT nao sao afetados, bem como os caracteres mostrados anteriormente. 
O INVERSE opera alterando um pouco o cédigo ASCII. Assim, qualquer caractere man- 
dado para o disco em video reverso sera guardado em cddigos incorretos. Ao serem lidos de volta, 
aparecerdao Caracteres errados. 
Nao disponivel em Integer BASIC. 


LET= 


Uma declaracao de atribuicdo, LET=, ou simplesmente =, atribui um valor a uma determinada 
variavel. 


Formato: 
[LET] var = expr 


A variadvel var passa a conter o valor obtido pelo calculo de expr. 


LIST 


Mostra todo ou uma parte do programa corrente na memoria. Existem dois formatos para o 
comando LIST. Um é reconhecido por Integer BASIC e Applesoft e o outro apenas pelo Apple- 
soft. Eles sdo descritos em separado abaixo. 
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Formato Geral: 


LIST lin, ry lin | 


Qualquer parte do programa pode ser listada. Se nado for colocada nenhuma linha a seguir do LIST, 
todo o programa é listado. Se apenas /in, esta presente, apenas aquela linha é listada, se existir. 
Se ambas as linhas estiverem presentes, o programa sera listado a partir da /in, e continuara até a 
ling. | 

Se a /in, nado existir, a listagem iniciara na proxima linha de numero mais alto. Se /inz nao 
existir, a listagem termina na Ultima linha de nUmero mais baixo. 

LIST nao pode ser usado com variaveis ou expressdes no lugar de nimeros de linhas. 

Quando o LIST mostra o programa, ele deixa espaco extra para variaveis e palavras reserva- 
das para tornar a listagem mais legivel. Se isso causar problemas, pode-se eliminar esse efeito 
reduzindo a janela de texto para o tamanho 33 (ou menos) com o comando POKE 33,33. (POKE 
33,40 ou TEXT devolve o tamanho normal para a janela de texto.) 

O comprimento das linhas de programa é limitado, porém é calculado antes que o LIST 
forneca espacos extra. Dessa forma pode-se estender o comprimento aparente das linhas de pro- 
grama deixando espacos ao se digitar as linhas. A desvantagem é que a linha sera muito longa 
para copiar e editar apos ser listada com muitos espacos incorporados. 


Formato (expandido) do Applesoft: 


ling Liz}] 
LIST ‘ 
lin, | {7} ling 


Em Applesoft, tanto a virgula (,), quanto o hifen (-) podem separar dois nimeros de linha. 

Em Applesoft também se pode listar a partir do inicio do programa até uma determinada 
linha colocando uma virgula ou hifen a frente da /in, (omitindo /in,). Também se pode listar a 
partir de um numero de linha especifico até o fim do programa colocando a virgula ou hffen 
apos /in, (e omitindo /in, ). 


LOAD 


Carrega um, é de cassette ou disco. 


Formato em Cassette: 


LOAD 


Carrega o programa sequencial seguinte a partir do cassette, colocando no lugar do programa 

corrente na memoria. Deve-se ter o gravador cassette rodando no modo PLAY quando o LOAD 

é executado; o Apple II nado da nenhuma informacao sobre isso. Ele da um b/p quando inicia o 

carregamento e outro quando termina. O segundo b/p informa que se deve desligar o gravador. 
SO pode ser usado em modo imediato no Integer BASIC. 
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Formato em Disco: 
LOAD nomearg [, Dn] [, Sn] [, Va] 


O programa de nome nomearg é carregado a partir do disco. Se a operacao for bem-sucedida, o 
programa anterior da memoria é apagado. 

Se 0 programa a ser carregado for em Applesoft e o Apple I! estiver em Integer BASIC, ou 
vice-versa, ele troca as chaves para a linguagem apropriada. Isso pode requerer o carregamento da 
linguagem a partir de um disco especifico. Se a linguagem nao estiver disponivel, a mensagem 
LANGUAGE NOT AVAILABLER aparece. 

Se 0 arquivo nao existir no drive Dn do slot Sn, a mensagem FILE NOT FOUND aparece. 
Se o disco no drive Dn e slot Sn nao tiver o volume Vn, 0 erro VOLUME MISMATCH é€ apresen- 
tado. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn e Sn sao omitidos, o Ultimo 
drive ou slot referenciado é usado. VO é adotado quando Vn estiver ausente. Também n pode 
estar ausente, sendo adotado DO, SO e VO. 

Este € um comando DOS, requerendo PRINT e CTRL-D em modo programado. 


LOCK 


Protege um arquivo em disco de eliminacdao acidental. 


Formato: 
LOCK nomearg |, Dn] |, Sn] [, Va] 


Uma vez protegido, um arquivo nao pode ser eliminado ou ter seu nome trocado até que seja 
desprotegido (veja UNLOCK). Nenhum programa pode ser guardado com o nome igual ao de um 
programa protegido. Um arquivo protegido é indicado no catdlogo do disco por um asterisco a 
esquerda do tipo do arquivo. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn e Sn sao omitidos, o Ultimo 
drive ou slot referenciado é usado. VO é adotado quando Vn estiver ausente. Também n pode 
estar ausente, sendo adotado, DO, SO e VO. 

Este 6 um comando DOS, requerendo PRINT e CTRL-D em modo programado. 


LOMEM: 


Determina o limite inferior de memoria disponivel para variaveis de programas BASIC. 


Formato: 


LOMEM: exprnm 


LOMEM: estabelece a menor posicado de memoria RAM disponivel para as linhas de programa 
e variaveis no BASIC. O Monitor e o interpretador BASIC usam memoria abaixo de LOMEM: 
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para apontadores, graficos em baixa resolucao e memoria de texto da tela etc. Quando o interpre- 
tador Applesoft é carregado do disco ou cassette, ele sempre reside em RAM abaixo de LOMEM.:. 
Pode-se adicionar ainda espaco para sub-rotinas em linguagem de maquina e tabelas de formas 
graficas de alta resolucdo com a declaracdo LOMEM:. 

Com Integer BASIC em Applesoft em firmware, LOMEM: é posicionado em 2048, imediata- 
mente acima da area usada pelo sistema. Carregando o interpretador Applesoft do disco ou cas- 
sette faz-se o LOMEM: subir para 12291. A cada vez que se adiciona uma linha de programa ou se 
modifica uma linha existente, o LOMEM: é ajustado para cima ou para baixo. Limpando-se um 
programa em Applesoft (com NEW ou CTRL-B) também se altera LOMEM:. Assim, se se deseja 
reservar espaco abaixo do programa, deve-se fazer isso apds limpar qualquer programa anterior 
e antes de carregar ou digitar o novo. 

O valor de exprnm deve estar entre —65535 e 65535 (—32767 até 32767 em Integer BASIC), 
ou um erro ocorrera. 

Pode-se ver o valor corrente de LOMEM: com a instrucdo PRINT PEEK(106) * 256 + 
+ PEEK (105). 

Em Applesoft, se LOMEM: é colocado com um valor maior que HIMEM: menor que o valor 
ja existente de LOMEM:, ou menor que a posicao mais alta de memoria usada para o sistema 
operacional corrente ou programa, a mensagem 7?OUT OF MEMORY ERROR. 

SO pode ser usado em modo imediato em Integer BASIC. 


MAN 


Termina numera¢gao automatica de linhas em Integer BASIC. 


Formato: 
MAN 


A numeracao automiatica de linhas inicia com AUTO. 


Digite CTRL-X para parar temporariamente a geracdo de numeros de linhas, digitando entao 
MAN. 
Nao disponivel em Applesoft. 


MAXFILES 


Especifica o numero maximo de arquivos em disco que podem ser ativados a qualquer tempo. 


Formato: 
MAXFILES /imite 


O sistema operacional (DOS) suporta um maximo de 16 arquivos abertos ao mesmo tempo. 
Quando executado, o MAXFILES reserva 595 bytes de memoria (um buffer de arquivo) para cada 
arquivo. MAXFILES é colocado em 3 automaticamente ao se carregar o DOS. 
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Todos os comandos do DOS exceto o MAXFILES usam o buffer de arquivo quando sao exe- 
cutados. Assim, o numero maximo de arquivos que se pode ter aberto na pratica 6 um a menos do 
limite de MAXFILES. Ao se tentar executar comandos DOS quando nao ha buffers disponiveis, a 
mensagem NO BUFFER AVAILABLE é gerada. 

MAXFILES opera com o HIMEM: quando executado, o que pode limpar parte de progra- 
mas, armazenamento de variaveis etc. Se possivel, execute MAXFILES antes de carregar e executar 
programas. 

Usando MAXFILES dentro de um programa Applesoft, use-o na primeira linha. Para usar 
MAXFILES em um programa Integer BASIC, deve-se criar um arquivo EXEC como visto no 
Capitulo 5 (veja também EXEC neste capitulo). 

limite deve ser uma constante na faixa de 1 a 16 ou um erro RANGE ERROR aparece. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 


MON 


Causa 0 aparecimento da tela dos comandos de disco e/ou fluxo de dados. 


Formato: 
MON [C][, !][, 0] 


Os trés pardmetros dizem o que sera mostrado. Se é especificado C, todos os comandos do disco 
sao mostrados na tela. Se é especificado |, todos os dados que o Apple I! recebe vindos do disco 
sao mostrados. Se é especificado O, toda a safda de dados do Apple !! para o disco é mostrada na 
tela. Estes pardmetros podem ser usados em qualquer ordem. Se nenhum deles estiver presente, o 
MON nfo tera efeito. O efeito do MON permanece até que seja executada uma declaracdo NOMON, 
FP ou INT, ou o sistema seja recarregado, ou em algumas maquinas, seja dado o RESET. 

Este 6 um comando DOS, e requer PRINT e CTRL-D quando usado em modo programado. 


NEW 
Elimina o programa corrente e todas as variaveis a ele associadas da memoria. 
Formato: 


NEW 


O NEW também reajusta o LOMEM:, porém HIMEM: COLOR e HCOLOR nfo sao afetados. 
O NEW so pode ser usado no modo imediato em Integer BASIC. 


NEXT 


Termina 0 /oop iniciado com a instrucdao FOR. 
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Formato Geral: 
NEXT varnm [, varnm] 


Quando NEXT é executado, a varidvel do /oop varnm é incrementada do valor especificado na 
declaragao FOR correspondente. O programa entdo, ou continua com a instrucdo que segue o 
FOR ou volta ao FOR correspondente, dependendo do estado dos pardmetros da declaracdo 
FOR. Veja o estudo da declaracéo FOR anteriormente elaborado, neste capitulo. 

Se nao houver nenhum FOR em processo que use a varidvel varnm, é acusado um erro. 
E mostrado ?NEXT WHITHOUT FOR ERROR no Applesoft, e *** BAD NEXT ERR no Integer 
BASIC. 

Variaveis multiplas seguintes ao NEXT devem ser listadas na ordem apropriada (o Ultimo 
loop iniciado deve ser terminado primeiro) ou um erro acontecera. 

O NEXT nao pode ser usado em modo imediato no Integer BASIC. Em Applesoft, um 
NEXT em modo imediato causa salto para a declaracdo FOR que estava sendo executada no 
modo programado que estava ativo. 


Formato Applesoft Adicional: 
NEXT 


Em Applesoft, pode-se usar NEXT sem identificacdo do nome da variavel. A varidvel adotada 
por auséncia é aquela do FOR que iniciou mais recentemente a ainda esta em efeito. NEXT sem 
variavel 6 executado mais rapidamente que o correspondente com variavel. 


NO DSP 


Cancela o modo display para a varidvel especificada em Integer BASIC. (Veja DSP.) 


Formato: 
NO DSP var 


Nao disponivel em Applesoft. 


NOMOM 


Finaliza a apresentacdo de comandos de disco e fluxo de dados iniciada com MON. 


Formato: 
NOMOM [C][, !][, 0] 


Cada parametro especificado cancela parte da apresentacdo iniciada com MON. Se C é especifi- 
cado, os comandos do disco nao s4o mostrados. Se | é especificado, os dados entrados do disco 
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para o Apple II nado sdo mostrados. Se O é especificado, os dados saidos do Apple II para o disco 
nado sdo mostrados. Esses pardmetros podem ser usados em qualquer combinacao e em qualquer 
ordem. Se MON no estiver em efeito para o parametro ou pardmetros especificados, ou nenhum 
pardmetro for especificado, o NOMOM nfo tera efeito. 

Este 6 um comando DOS, e requer PRINT e CTRL-D quando em modo programado. 


NORMAL 


Esta declaracdo do Applesoft desliga os modos de video FLASH e INVERSE. 


Formato: 
NORMAL 


Veja FLASH e INVERSE. 
Ndo disponivel em Integer BASIC. 


NO TRACE 


Cessa o acompanhamento da execucdo do programa iniciado com TRACE. 


Formato: 


NO TRACE 


Se TRACE ndo estiver em efeito, NO TRACE também no tera efeito. 


ONNER GOTO 


Pula para a linha de nimero indicado quando acontecer erro num programa Applesoft. 


Formato: 
ONNER GOTO /inha 


Este comando liga um indicador que causa o salto do programa para a linha de numero indicado 
quando um erro é detectado. ONNER GOTO deve ser dado antes que um erro ocorra. 

Cada tipo de erro tem um cédigo associado. O codigo do erro mais recente detectado fica 
guardado na posicdo de memoria 222. PEEK (222) pega o cddigo de erro. Os cddigos de erro e suas 
mensagens sdo dados na Tabela C.1 (Apéndice C). Quando um erro ocorre dentro de um /oop 
FOR-NEXT ou numa sub-rotina, os apontadores e as pilhas sdo alterados. A rotina de erro deve 
voltar para o inicio da declaragdéo FOR ou GOSUB, reiniciando o /oop ou a sub-rotina. Se a rotina 
de erro voltar para o NEXT ou o RETURN, outro erro podera ocorrer. 
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ONNER GOTO nfo funciona corretamente em algumas circunstancias. O Apple I! trava se 
existem dois erros GET numa coluna e a rotina de manipulacdo de erros termina com RESUME, 
e nao GOTO. Em programas que usam declaracdes PRINT (ou se o TRACE esta em efeito), o 
43° erro nao vindo de uma declaracaéo INPUT causa um salto para o MONITOR. Nesta situacdo, 
se o GOTO termina uma sub-rotina de manipulacado de erro (em lugar de RESUME), o 879 erro 
de INPUT causa um salto para o Monitor. 

Pode-se contornar todos esses problemas descritos se a rotina de tratamento de erro incluir 
uma chamada para o programa em linguagem de maquina descrito na Tabela 8.4. 


ON-GOSUB 


Possibilita chamada opcional para uma das varias sub-rotinas num programa em Applesoft, depen- 
dendo do valor atual de uma expressdao. 
Formato: 

ON exprnm GOSUB /inha [, linha... | 


O programa salta para a primeira linha se o valor inteiro da expressdo é 1, para o segundo se é 
2 etc. O proximo RETURN encontrado faz o programa voltar para a declaracdo seguinte ao ON- 
GOSUB. 

A expressdo deve ter um valor na faixa entre 0 e 255 ou a mensagem ?ILLEGAL QUANTITY 


TABELA 8.4. Programa em Linguagem de Maquina para ONNER GOTO. 


LINGUAGEM DE MAQUINA LINGUAGEM ASSEMBLER DO 6502 
[ent [Homma | ives [ome 
104 


PLA 






















Coloca o maior byte do stack no 
Acumulador 

Salva-o no Registrador [ndice Y 

Pde o prdéximo byte no Acumulador 

Usa apontador do ONNER GOTO 














TAY 
PLA 
LDX $DF 












TXS 
PHA 
TYA 
PHA 







como endereco de pilha 

Joga o conteudo salvo da pilha na 
pilha “ONNER GOTO” (dois 
bytes do Acumulador e do regis- 
trador Y) 

Retorna ao Applesoft 






RTS 
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ERROR ocorre. Se o calculo da expressdo der zero ou um valor maior que o nimero de linhas 
listado, a execucao do programa continua a partir da linha seguinte ao ON-GOSUB. 

Nao disponivel em Integer BASIC. (Mas veja o GOSUB, e a forma do GOSUB calculado para 
o Integer BASIC.) 


ON-GOTO 


Causa um salto condicional para um dos varios pontos do programa Applesoft, dependendo do 
valor corrente de uma expressao. 


Formato: 
ON exprnm GOTO /inha [, linha... | 


O programa salta para o primeiro numero de linha se o valor inteiro do calculo da expressdo é 1, 
para Oo segundo se é 2 etc. 

A expressdo deve ter um valor numérico entre 0 e 255, ou a mensagem ?ILLEGAL QUAN- 
TITY ERROR aparece. Se a expressdo calculada der zero ou um valor acima do nimero de linhas 
listado, a execucao do programa continua na primeira linha a seguir do ON-GOTO. 

Nao disponivel em Integer BASIC. (Veja GOTO para Integer BASIC, na forma de GOTO 
calculado.) 


OPEN 


Prepara um arquivo de texto sequencial ou aleatorio para acesso. 


Formato: 
OPEN nomearg [, Ln] [, Dn] [, Sn] [, Va] 


Um buffer na memoria de 595 bytes é alocado para o arquivo de texto especificado. Os coman- 
dos READ e WRITE podem agora ser usados como arquivo para obter e guardar informacao. Se o 
arquivo especificado nao esta no disco, é criado um. Se ele ja esta aberto, ele é fechado e em segui- 
da reaberto. 

Se o pardmetro L nao é especificado, 0 arquivo é aberto como seqlencial. 

Se o pardmetro L é especificado, 0 arquivo é aberto como de acesso aleatorio. O numero n 
seguinte ao L é o tamanho do registro em bytes e deve ser uma constante inteira na faixa de 1a 
32767. Ele pode estar ausente; sendo usado L1. Cada vez que um arquivo particular de acesso 
aleatorio é aberto, o tamanho do registro deve ser 0 mesmo. 

Se o disco no drive Dn do slot Sn nao tiver o volume Vn, ocorre o erro VOLUME MIS- 
MATCH. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn ou Sn é omitido, o drive 
referenciado por Ultimo é usado. E usado VO se Vn esta ausente. Também n pode estar ausente, 
quando é adotado DO, SO e VO. 
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Este €é um comando DOS e requer PRINT e CTRL-D quando em modo programado. 
OPEN ndo pode ser usado em modo imediato. 


PDL 


Listado na secao de funcoes deste capitulo. 


PEEK 


Listado na secdo de funcGes deste capitulo. 


PLOT 


Mostra um ponto da tela grafica de baixa resolucdo. 


Formato: 
PLOT col, lin 


Em modo grafico de baixa resolucao, PLOT coloca um ponto colorido na tela. A cor do ponto é 
determinada pela Ultima declaracdo COLOR executada. O numero de coluna varia de 0 a 39. 
A coluna O é a mais a esquerda da tela; e a coluna 39 é a mais a direita. Os nUmeros de linha vao 
de 0 a 47. Linha O é a de cima da tela e 47 é a de baixo. Um ponto colocado nas linhas 40 até 
47 cairaé nas quatro linhas da janela de texto a menos que uma declaracgdo POKE —16302,0 
seja executada para eliminar a janela de texto. 

No modo texto ou na janela de texto, o PLOT coloca um caractere colorido, ao invés de um 
ponto na tela. Desde que um caractere ocupa o espaco de dois pontos verticais empilhados, exis- 
tem dois conjuntos diferentes de coordenadas PLOT que causam o aparecimento de um dado 
Caractere num mesmo ponto. Para colocar um caractere particular na tela, deve dar PLOT em 
ambas as metades da posicdo do caractere. O caractere que aparece é determinado pela decla- 
ragao COLOR executada por Ultimo antes que cada metade seja desenhada. 

A Tabela 8.5 mostra os caracteres gerados em cada combinacdo de cores nos pontos supe- 
rior e inferior. Para gerar um caractere particular, ache-o na Tabela 8.5; veja para cima e para a 
esquerda para ver a cor que se deve usar no PLOT em cada metade do caractere. A metade superior 
do caractere 6 especificado por um PLOT em uma linha (mpar, e a metade de baixo por um PLOT 
em uma linha impar. Se apenas for desenhada a metade de um Caractere, o caractere gerado é 
baseado na cor do PLOT e na cor ja presente no outro ponto grafico desenhado. 

Note que cada caractere pode ser gerado por quatro cores diferentes para o ponto grafico 
inferior. Entretanto eles nado sao idénticos. O caractere gera em video reverso se o numero da cor 
do ponto inferior for menor que 4, e estard piscando se o numero estiver entre 4 e 7, sendo da 
forma normal na faixa entre 8 e 15. 
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TABELA 8.5. Caracteres Gerados por Declaracdes Graficas em Modo Texto. 


MODO VIDEO COR DO PONTO GRAFICO SUPERIOR 
























Para Para Para 
Video Caracteres | Caracteres 
Inverso Piscando Normais 0123 4 5 6 7 8 JY 10 11 12 13 14 15 






PONTO GRAFICO 
INFERIOR 


POKE 


A declaracgado POKE guarda um byte de dado numa posicao de memoria especificada. 


Formato: 
POKE endmem, byte 


Um valor entre 0 e 255, fornecido por byte, é escrito no endereco de memoria endmem. Se a 
posicao de memoria especificada exceder 0 maximo tamanho de memoria existente (exemplo, 
16383 para sistema com 16K), ou acessar um dispositivo de safda que nado esta operando, o POKE 
nao tera efeito. 

Use com cuidado o POKE. Algumas posicdes de memoria contém informacdao essencial para 
a operacdo ininterrupta do Apple ||. Mexer nessas posic¢des de memoria pode destruir 0 programa, 
travar o sistema ou alterar o BASIC. 


POP 


Faz com que o Apple II esqueca a posicao de retorno para o mais recente GOSUB executado. 


Formato: 


POP 


O POP efetivamente muda o GOSUB mais recentemente executado em uma declaracdo GOTO 
(a posteriori). A proxima declaragdo RETURN executada pulara para a instru¢do em seguida ao 
segundo mais recente GOSUB executado. Se o numero total de declaracdes POP e RETURN 
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executadas num programa exceder o numero de declaracdes GOSUB, ocorre uma mensagem 
de erro. 


POSITION 


Ao mover o apontador de arquivo do disco move-se um determinado numero de posicOes para a 
frente. 


Formato: 


POSITION nomearg |, Rn| 


Se o arquivo nao estd aberto quando POSITION é executado, ele é aberto (veja OPEN). O para- 
metro R especifica quantos campos o apontador de arquivo se move para a frente a partir de sua 
posicdo presente. O nimero a seguir ao R deve ser uma constante inteira num valor entre 0 e 
32767. Se ausente, o pardmetro adotado é O, ou seja, o apontador ndo se move. Se o arquivo é 
aberto por POSITION, os campos s4o contados a partir do seu inicio. Esse arquivo deve ser se- 
quencial. 

Um campo consiste numa série de caracteres terminados com um carriage return. O POSI- 
TION vai ao longo do arquivo, caractere por caractere, contando tais caracteres; o numero de 
carriages returns encontrado é o numero de campos pulados. Se qualquer caractere nao usado é 
encontrado, a mensagem END OF DATA aparece. 

Este € um comando DOS, e requer PRINT e CTRL-D em modo programado. 

POSITION nao pode ser usado em modo imediato. 


PR# 


Seleciona o slot que ira receber as proximas sa/das. 


Formato: 


PR# slot 


Toda declaracdéo PRINT a seguir vai mandar dados para o periférico do slot indicado. s/ot deve ser 
um inteiro entre 0 e 7. O slot 0 nao é um dispositivo periférico. PR#0 especifica a tela de video 
como saida. Se nao houver periférico no slot especificado, o sistema travara até que seja acio- 
nado RESET. 

Sempre que o DOS estiver presente na memoria do Apple II, PR# sera considerado um 
comando DOS, e vai requerer PRINT e CTRL-D em modo programado. 


PRINT 


Manda caracteres para a tela ou outro dispositivo de safda. 
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Formato: 
PRINT [expr] [('}. . [expr]. . .] 


Existem diversas variacdes aceitaveis da declaracdo PRINT. O PRINT sozinho manda um caractere 
carriage return e line feed. Quando é seguido por uma ou mais express6es, o valor dessas expressOes 
é mostrado. A forma como os valores aparecem depende de sua natureza e do uso de ponto-e-vir- 
gula ou virgula entre eles. 

Todos os valores numéricos em Integer BASIC e muitos em Applesoft sao mostrados usando 
representacao numérica padrao. Valores negativos sao precedidos pelo sinal de menos; valores 
positivos ndo sao precedidos por sinal ou espaco em branco. E usada notacao cientifica em Apple- 
soft para valores mais proOximos de zero que +0.01 e por qualquer valor com mais de nove digitos 
antes do ponto decimal. 

Os valores cordao aparecem da forma como sao. 

Virgulas (,) e pontos-e-virgulas (;) determinam o espaco entre cada valor mostrado. Um 
ponto-e-virgula faz o valor seguinte ser impresso imediatamente apds o Ultimo mostrado; eles ficam 
concatenados sem nenhum espaco intermediario. Uma virgula faz o proximo valor ser colocado 
na posi¢do de tabulacdo seguinte, alguns espacos a frente a partir do Ultimo valor. 

Em Integer BASIC, as posicdes de tabulacao sao as colunas 1, 9, 17 etc. Se algum caractere 
diferente de espaco é colocado no espaco anterior ao de tabulacdo (ex. na coluna 16), aquela 
posicao de tabulacao ficara desativada. 

O Applesoft coloca posi¢des de tabulacdo em intervalos de 16, nas colunas 1, 17, 33 etc. 
As paradas de tabulacdo na tela serdo inativadas de acordo com o esquema ilustrado na Tabela 4.1 
(Capitulo 4). Para outros dispositivos, uma parada de tabulacao sera desativada se houver um 
Caractere em sua coluna anterior (ex. coluna 32). 

Se uma lista de expressdes ndo termina com virgula ou ponto-e-virgula, 6 dado um carriage 
return e line feed depois do Ultimo item da lista. Se ela termina com ponto-e-virgula, o primeiro 
Caractere que aparecer na declaracdo NEXT seguinte aparecera imediatamente ao Ultimo caractere 
mostrado pela declaracdo PRINT atual, sem espacos. Se a lista termina com virgula, a proxima 
safda iniciara com o caractere na posicdo de tabulacdo seguinte. 

Em Integer BASIC, todos os itens devem ser separados ou por virgula, ou por ponto-e-vir- 
gula. Em Applesoft, os itens podem ser listados sem virgulas ou pontos-e-virgulas intermedidrios. 
A saida para tais itens fica concatenada como se eles fossem separados por pontos e virgulas. 

O Applesoft reconhece o ponto de interrogacdo (?) com abreviacao de PRINT. Neste caso a 
palavra PRINT sera apresentada na listagem do programa. 


READ (DECLARACAO DE DISCO) 
Especifica o arquivo em disco de onde os comandos GET e INPUT pegardo dados. 
Formato: 


READ nomearg |, Rn|[, Bn] 


Se o arquivo ainda nao esta aberto, ele é aberto (veja OPEN). Toda declaracéo GET e INPUT 
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recebe caracteres do disco até que uma declaracdo de disco (ou um caractere CTRL-D (cddigo 
ASCII 04) sozinho), RESET seja acionado, ou ocorra um erro. Se o arquivo nado estiver no disco 
a mensagem FILE NOT FOUND aparece. 

O arquivo sera lido como seqiiencial se o pardametro R estiver ausente. Num arquivo sequen- 
cial, Oo pardmetro B especifica em qual byte esta (caractere) o READ inicial. Nao tendo B, o READ 
inicia a partir do primeiro byte (byte 0). Se o byte a ser lido nunca foi gravado no disco por meio 
da declaracdo WRITE, aparece a mensagem END OF DATA ao se executar alguma instrucdo 
INPUT E GET subsequente. 

Se o parametro R esta presente, o arquivo sera acessado como de acesso aleatorio. O para- 
metro R especifica que registro sera acessado com READ. 

Num arquivo de acesso aleatorio, o pardmetro B especifica em qual byte do registro especi- 
ficado a leitura se inicia. Sem o pardmetro B, o READ inicia no primeiro byte do registro (byte 0). 
Se o byte a ser lido nao foi gravado no disco antes com WRITE, a mensagem END OF DATA 
aparece na declaracdo INPUT ou GET executada em seguida. 

Os ndmeros que seguem B e R devem ser constantes inteiras entre 0 e 32767. Se nao especi- 
ficadas, 0 é assumido. 

Nao use o CTRL-C para parar uma declaraca€o READ no Applesoft. Isso causa uma série de 
mensagens ?REENTER. Use apenas o RESET para parar o programa. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 

Nao pode ser usado em modo imediato. 


READ (DECLARACAO DE ATRIBUICAO) 


Associa valores de DATA do Applesoft a variaveis. 


Formato: 
READ var[,var... | 


Existe um apontador para a lista de dados DATA que determina qual valor deve ser associado a 
variavel da declaragdo READ. No inicio do programa e apos a declaragéo RESTORE, o apontador 
indica o primeiro valor de DATA. A cada declaragéo READ em que se atribui um valor para a 
variavel, 0 apontador passa para o valor seguinte. 

As variaveis podem ser de qualquer tipo, porém devem coincidir com o tipo de dado indi- 
cado pelo apontador do DATA. Um valor numérico atribufdo a uma variavel cordao causa pro- 
blemas. Um cordao associado a uma variavel numérica causa 0 aparecimento da mensagem de 
erro 2SYNTAX ERROR. O ntmero de linha do DATA envolvido também é mostrado com a 
mensagem. 

Se o READ tenta ler mais varidveis que as existentes na declaracdo data, a mensagem ?OUT 
OF DATA ERROR é mostrada, com o nimero da declaragéo READ onde houve o erro. 

O READ pode ser executado em modo imediato, desde que o programa na memoria tenha 
valores em DATA correspondentes. De outra forma, a mensagem ?O0OUT OF DATA ERROR 
aparece. Se o DOS esta presente, o READ em modo imediato é tratado como um comando DOS, 
e amensagem NOT DIRECT COMMAND 6€ apresentada. 

Nao disponivel em Integer BASIC. 
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RECALL 


Pega um arranjo numérico do Applesoft a partir da fita cassette. 


Formato: 
RECALL varnm 


O Applesoft espera indefinidamente até que um arranjo seja achado na fita; nenhuma outra decla- 
ragao pode ser executada nesse ‘nterim. OQ RECALL nao controla o movimento da fita nem infor- 
ma quando acionar o botao PLAY do gravador. Deve-se acrescentar informacao através de PRINT 
antes de uma declaragado RECALL advertindo o inicio do processo. O Apple I! também sinaliza 
com bip quando comega a carregar um arranjo e da outro bip quando para. O arranjo deve ser 
dimensionado antes da declaragéo RECALL ser executada, ou a mensagem ?0UT OF DATA 
ERROR aparece (veja DIM). 

Na declaragdo RECALL nao é necessdrio usar os mesmos nomes de variadveis usados na decla- 
ra¢ao STORE que gravou o arranjo. Se o arranjo da fita contiver mais elementos que os solicitados 
pelo RECALL, o erro ?OUT OF DATA ERROR aparece. Se o arranjo chamado contém no mini- 
mo tantos elementos quantos foram gravados, porém sem as mesmas dimensGes a mensagem ERR 
é gerada, porém a execucdo do programa continua. 

Se oO arranjo chamado tiver mais elementos que o gravado, os valores obtidos normalmente 
sao danificados. Existem duas opcodes. Pode-se chamar para um arranjo com o mesmo numero de 
dimensdes do gravado, onde cada dimensdo exceto a Ultima tenha o mesmo tamanho da dimensdo 
correspondente do arranjo gravado. A ultima dimensao pode ser mais larga no arranjo chamado. 
Pode-se também chamar para um arranjo com mais dimensGdes que o gravado, se as dimensdes 
que estao no arranjo coincidem com aquelas do arranjo chamado (ou as exceda, no caso de ultima 
dimens4ao do arranjo gravado). 

Arranjos tipo cordao nao podem ser usados com RECALL. Porém os valores numéricos po- 
dem ser convertidos para corddo usando a funcdo CHR$. 

Nao disponivel em Integer BASIC. 


REM 


A declarac¢do REM permite comentarios a serem colocados no programa para efeito de docu- 
mentacdo. 


Formato: 
REM comentdrio 


comentdrio é qualquer sequéncia que caiba na linha de programa. 

As declaragoes REM sao reproduzida na listagem do programa, porém sao ignoradas durante 
sua execucao. A declaracdo REM pode ser colocada numa linha sozinha ou como uma das decla- 
racoes de uma linha multipla. 
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O REM no pode ser colocado a frente de outras declaragdes numa linha miultipla, porque 
todo o texto que segue é tratado como um comentario. 


RENAME 


Troca o nome de um arquivo em disco sem alterar seu contetido. 


Formato: 
RENAME nomearg,, nomearq, |, Dn] [,Sn][, Va] 


O arquivo com nome nomearg, é achado no disco, e tem seu nome trocado por nomearg,. Se o 
arquivo esta aberto, ele 6 fechado (veja CLOSE). O arquivo nao é afetado em seu contetdo. 

RENAME pode trocar 0 nome do arquivo por outro que ja exista dentro do disco; e pode 
fazé-lo muitas vezes, Por isso deve-se ter cuidado para nao escolher para um arquivo um nome que 
ja exista no disco, antes de executar o RENAME. 

Se nomearq, nado existe no drive Dn do slot Sn, a mensagem de erro FILE NOT FOUND 
aparece. Se o disco no drive Dn do slot Sn ndo tem volume Vn, a mensagem VOLUME MISMATCH 
aparece. 

Dn, Sn e Vn podem aparecer em qualquer ordem. Se Dn e Sn sao omitidos, o drive referen- 
ciado por ultimo é usado. VO é usado se Vn nao for colocado. Também rn pode estar ausente, 
quando DO, SO e VO sao adotados. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 


RESTORE 


Coloca o apontador do DATA no inicio da lista. 


Formato: 
RESTORE 


A declaracao READ subseqiente vai operar a partir do primeiro valor da lista do DATA. 
Nao disponivel em Integer BASIC. 


RESUME 


Faz o programa em Applesoft voltar a execucao no inicio da instrucao onde o erro ocorreu. 


Formato: 


RESUME 
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O RESUME nfo pode ser usado apds uma declaragdo ONERR GOTO ter sido usada no trata- 
mento do erro. Se o RESUME é executado sem ter ocorrido erro, o resultado é imprevisivel, mas 
em geral tragico. 

Nao disponivel em Integer BASIC. 

N&o pode ser usado em modo imediato. 


RETURN 


Faz o programa saltar para a declaracdo abaixo da ultima declarag¢ao GOSUB executada. 


Formato: 
RETURN 


A declaragaéo POP faz o programa esquecer o endereco de retorno do GOSUB mais recente. 
Uma declaragdo RETURN apos um pop faz voltar para o endereco seguinte ao segundo mais 
recente GOSUB. 

Se forem executadas mais declaracOes RETURN (ou POP) do que GOSUB, aparece uma 
mensagem de erro. 


ROT= 


Esta declaracdo do Applesoft muda a orientacao do desenho da forma grafica de alta resolucao 
feito por DRAW ou XDRAW. 


Formato: 


ROT = exprnm 


ROT=O desenha a forma na orientacao que foi definida. A forma é rodada em 90 graus em 
sentido horario para cada incremento de 16 no valor de exprnm. Assim, ROT =32 desenha uma 
forma de cabeca para baixo, e ROT=64 desenha-a em sua forma original. Valores de exprnm 
maiores que 64 ndo calculados no médulo 16. 

Quando SCALE foi colocado em 1, s6 existem quatro formas possiveis de ROT =. Sao elas 
0, 16, 32 e 48 (e os valores maiores que 63 equivalentes). Quando SCALE é igual a 2, ficam 
existindo oito valores possifveis para ROT=, quando SCALE=3, existem 16 valores etc. até o 
maximo de 64 valores diferentes. Um valor nado reconhecivel do ROT = sera tratado como se fosse 
o valor reconhecivel seguinte. 

exprnm deve ter um valor calculado entre 0 e 255 ou amensagem ?ILLEGAL QUANTITY 
ERROR é gerada quando 0 comando ROT = é executado. 

ROT= nao é reconhecidao como uma palavra reservada, a menos que o caractere =" 
seja O primeiro caractere diferente de espaco. 

Nao disponivel em Integer BASIC. 
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RUN (DECLARACAO DE DISCO) 


Carrega e executa um programa do disco. 


Formato: 
RUN nomearg [, Dn] [, Sn] [, Va] 


O programa chamado nomearg é carregado do disco e executado. Se o carregamento for correto, 
qualquer programa anterior da memoria é zerado. 

Se o programa a ser carregado for em Integer BASIC e o Apple II estiver em Applesoft, ou 
vice-versa, ele fara a mudanca automaticamente para a linguagem adequada. Se necessdrio carre- 
gara o interpretador Applesoft a partir do disco especificado. Se a linguagem n€o estiver disponi- 
vel, a mensagem LANGUAGE NOT AVAILABLE aparecera. 

Se 0 arquivo nao existe no drive Dn do slot Sn, a mensagem FILE NOT FOUND aparecera. 
Se o disco do drive Dn do slot Sn nao tiver volume Vn a mensagem de erro VOLUME MISMATCH 
aparecera. 

Dn, Sn e Vn podem ser especificados em qualquer ordem. Se Dn e Sn sao omitidos, o drive 
referenciado por Ultimo é adotado. VO é usado por auséncia de Vn. Também rn pode estar ausente, 
quando DO, SO e VO sao adotados. 

Este é um comando DOS e requer PRINT e CTRL-D em modo programado. 


RUN (DECLARACAO GERAL) 


Executa o programa presente na memoria, iniciando no numero de linha especificado, se existir; 
de outra forma, é usado o endereco mais baixo do programa. 


Formato Geral: 
RUN [/inha | 


Se nado existir linha de nome /inha a mensagem *** BAD BRANCH ERR em Integer BASIC e 
?UNDEF’D STATEMENT ERROR em Applesoft aparecera. 


Formato Adicional do Integer BASIC: 
RUN exprnm 


Em Integer BASIC, 0 numero de linha pode ser uma expressao numérica. 
RUN so pode ser usado no modo imediato em Integer BASIC. 


SAVE 


Guarda o programa da memoria em cassette ou disco. 
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Formato em Cassette: 


SAVE 


Guarda o programa presente na memoria em fita cassette. Deve-se ter a fita em modo RECORD 
quando SAVE é executado. O Apple II nao indica quando fazé-lo. Ele apita quando inicia a 
gravacdo do programa e apita de novo quando termina. O segundo apito é o sinal para parada 
manual do gravador. 

SO pode ser usado em modo imediato em Integer BASIC. 


Formato em Disco: 
SAVE nomearg |, Dn|[, Sa][, Va] 


Se ndo existe arquivo com nome nomearg no disco, é criado um com aquele nome e a linguagem 
do programa atual. O programa é guardado. Se existe um arquivo chamado nomearq na mesma 
linguagem do programa corrente, 0 contetido daquele arquivo é zerado e o programa corrente é 
guardado em seu lugar. Se 0 programa nomearg existe, porém em linguagem diferente ou com tipo 
diferente, a mensagem FILE TYPE MISMATCH aparece. 

Se oO arquivo nao existe no drive Dn do slot Sn, a mensagem FILE NOT FOUND aparecera. 
Se o disco do drive Dn do slot Sn nao tiver volume Vn a mensagem de erro VOLUME MISMATCH 
aparecera. 

Dn, Sn e Vn podem ser especificados em qualquer odem. Se Dn e Sn sao omitidos, o drive 
referenciado por Ultimo é adotado. VO é usado por auséncia de Vn. Também rn pode estar ausente, 
quando DO, SO e VO sao adotados. 

Este é um comando DOS e requer PRINT e CTRL-D em modo programado. 


SCALE 


Esta declaracdo Applesoft da o tamanho da forma grafica de alta resolu¢ao desenhada por DRAW 
ou XDRAW. 


Formato: 


SCALA= exprnm 


O tamanho da forma da tabela é multiplicado pelo valor de exprnm. Assim, se SCALE=1 a forma 
sera desenhada como foi definida. Se SCALE=2 serdé desenhada com o dobro do tamanho. Se 
SCALE=0, a forma sera desenhada 255 vezes maior que o tamanho original. 

O valor de exprnm deve ser um inteiro entre 0 e 255 ou a mensagem ?7ILLEGAL QUANTITY 
ERROR ocorre quando 0 comando SCALE é executado. 

SCALE ndo é reconhecido como palavra reservada a menos que o Caractere ‘’="’ seja o 
primeiro a seguir diferente de branco (espaco). 

Nao disponivel em Integer BASIC. 
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SHLOAD 


Esta declaragado do Applesoft carrega uma forma grafica de alta resolucao da fita cassette. 


Formato: 


SHLOAD 


A construcdo e o armazenamento de forma grafica em cassette é estudada no Capitulo 6. 
A forma grafica é carregada imediatamente abaixo de HIMEM: e HIMEM. é colocado imedia- 


tamente abaixo da forma. Entaéo o endereco inicial da forma é carregado nos enderecos de memo- 
ria 22 e 23. 

Antes que se execute SHLOAD certifique-se de ter colocado HIMEM: de forma que a tabela 
nao seja carregada sobre o programa ou variaveis e nao va ser zerada pelos graficos. Veja o estudo 
sobre HIMEM: neste capitulo, mapas de memoria no Apéndice G e no Capitulo 6 para maiores 
detalhes. 


Nao disponivel em Integer BASIC. 


SPEED 


Esta declaracdo Applesoft troca a freqiiéncia com que os caracteres sao safdos. 


Formato: 


SPEED = exprnm 


O valor de exprnm determina a frequéncia com a qual os caracteres aparecerao na tela ou outro 
dispositivo de saida. A velocidade varia de 0 (mais lenta) até 255 (mais rdpida). 
Nao disponfvel em Integer BASIC. 


STOP 


Faz o Applesoft parar a execucao do programa. 


Formato: 


STOP 


O Apple II retorna ao modo imediato. A mensagem BREAK IN linha aparece, onde linha é o 
numero da linha na qual o programa parou. 
Nao disponivel em Integer BASIC. 
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STORE 


Guarda um arranjo especifico do Applesoft em fita cassette. 


Formato: 


STORE varnm 


O STORE naocontrola o movimento da fita nem adverte quando se deve acionar o botaa RECORD 
do gravador. Deve-se ter 0 cassette rodando e pronto para gravar quando o STORE 6 executado. 
O programa em Applesoft deve mostrar indicacdes (via declaracdo PRINT). O Apple II sinaliza 
quando inicia a guarda de valores e sinaliza de novo quando termina. 

SO se pode usar STORE para guardar valores numéricos; variaveis cordado devem ser conver- 
tidas para valores inteiros usando a funcdo ASC antes de salvar (veja também RECALL). 

Nao disponivel em Integer BASIC. 


TAB 


Esta declaracdo em Integer BASIC posiciona o cursor numa coluna espec/fica na linha corrente. 


Formato: 
TAB co/ 


O cursor se move para a direita ou para a esquerda de acordo com o valor de co/, sem zerar os 
caracteres j4 mostrados. As colunas s4o numeradas de 1 a 40 (da esquerda para a direita). 

Para Applesoft, use a declaracdo HTAB. Veja também a funcado TAB na secao sobre funcdes 
neste capitulo. 


TEXT 


Retorna a tela para o modo texto a partir de qualquer um dos modos graficos. 


Formato: 


TEXT 


O caractere de entrada e o cursor sdo movidos para a Ultima linha da tela; se em modo texto 
este é o Unico efeito. Se a janela de texto foi colocado como algo diferente de tela cheia, o TEXT 
apaga a tela cheia. 

O TEXT nao apaga a tela, ou mais precisamente, nao limpa a pagina 1 de memoria de baixa 
resolucdo. Desde que 0 modo texto normal usa a mesma tela que o grafico em baixa resolucao, a 
execucao de TEXT no modo grafico de baixa resolucdo deixa as 20 linhas de cima da tela cheias 
de caracteres estranhos. 
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TRACE 


Mostra o numero da linha de cada declaracdo executada. 


Formato: 


TRACE 


Esta ferramenta de depuracdo causa o aparecimento dos numeros das linhas entremeado com os 
caracteres saidos pelo programa, o que pode tornar um ou ambos ininteligiveis. O TRACE é desa- 
tivado com o NO TRACE. 


UNLOCK 


Remove o estado de travado de um arquivo em disco, de forma que ele pode ser alterado ou 
eliminado. 


Formato: 
UNLOCK nomearg |, Dn] [, Sn] [, Vn] 


Se o arquivo especificado estd travado, a trava é removida. Se nado, nada acontece (veja LOCK). 
Se 0 arquivo nado existe no drive Dn do slot Sn, a mensagem FILE NOT FOUND aparece. 
Se o disco no drive Dn do slot Sn nao tem volume Vn, aparece o erro VOLUME MISMATCH. 
Dn, Sn e Vn podem aparecer em qualquer ordem. Se Dn e Sn sao omitidos o drive referen- 
ciado por ultimo é usado. Quando Vn esta ausente, VO é adotado. Também 7 pode estar ausente, 
quando DO, SO e VO sao adotados. 
Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 


USR 


Listado na parte de funcoes deste capitulo. 


VERIFY 


Verifica um arquivo especifico em disco para testar autoconsisténcia. 


Formato: 
VERIFY nomearg [| , Dn] [, Sn] [, Va] 


Quando um arquivo é guardado em disco com SAVE, BSAVE ou PRINT, é calculado um digito 
de verificag¢ao para cada setor, que também é gravado no disco. O VERIFY recalcula este digito e 
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O compara com o gravado. Se eles coincidirem, o arquivo esta intacto e nada aparece na tela. Se 
ocorrerem erros em um ou mais setores, a mensagem |/O ERROR 6 gerada. Pode ser verificado 
qualquer tipo de arquivo. 

Se 0 arquivo nao existe no drive Dn do slot Sn, a mensagem FILE NOT FOUND aparece. 
Se o disco no drive Dn do slot Sn nao tem volume Vn, aparece o erro VOLUME MISMATCH. 

Dn, Sn e Vn podem aparecer em qualquer ordem. Se Dn e Sn sao omitidos o drive referen- 
ciado por ultimo é usado. Quando Vn esté ausente, VO é adotado. Também rn pode estar ausente, 
quando DO, SO e VO sao adotados. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 


VLIN 


Desenha uma linha vertical na tela, na forma grafica de baixa resolucao. 


Formato: 
VLIN /in,, ling, AT col 


A linha é desenhada de /in, até /iny na coluna especificada por co/. A cor é determinada pela 
declara¢ao COLOR executada por ultimo. Se a tela estiver em modo texto, ou se a janela de texto 
estiver presente com a linha maior que 39, parte ou a totalidade da linha aparecera como caracteres 
ao invés de pontos. Os caracteres usados sdo determinados pela declaracdo COLOR anterior; 
veja a Tabela 8.5 (perto da declaracdo PLOT neste capitulo) para particularidades. 

Em Integer BASIC, /in, deve ser menor ou igual a /inz, ou a mensagem *** RANGE ERR 
aparece. 


VTAB 


Posiciona o cursor para uma linha especificada na coluna atual. 


Formato: 
VLIN /in 


O cursor se move para cima ou para baixo até a linha especificada pelo valor de /in, sem zerar 
nenhum dos caracteres da tela. As linhas sio numeradas de 1 a 24 (de cima para baixo). 


WAIT 


Para a execucao de um programa Applesoft até que um endereco de memoria tenha uma con- 
di¢ao especificada. 
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Formato: 
WAIT endmem, exprnm, |, exprnm, | 


O WAIT verifica parte ou o total dos oito bits da posicao de memoria endmem, para testar o pa- 
drao de uns e Zeros especificado por exprnm,. O valor binario de exprnm, determina quais bits 
da posicao de memoria devem ser considerados e quais devem ser ignorados. Se um bit de exprnm, 
é 1, entdo o bit correspondente da posicdo endmem é testado. O WAIT ignora aqueles bits de 
memoria que sdo correspondentes a 0 no valor binario de exprnm . 

Enquanto os bits significativos (determinados por exprnm,) de endmem forem todos dife- 
rentes do valor correspondente de exprnm,, a espera continua. No momento em que qualquer par 
for idéntico (ou 1 ou O) a espera termina e o programa Applesoft continua. 

Se exprnm, nao esta presente, é adotado 0. 

O WAIT so pode ser interrompido por RESET (ou desligamento). O valor das expressdes 
numéricas devem estar na faixa de 0 até 255 ou a mensagem ?ILLEGAL QUANTITY ERROR é 
gerada. Se a posic¢do de memoria especificada é maior que a posic¢do de memoria mais alta, (ex. 
32767, com 32K de memoria), ou acessar um dispositivo de safda que nao esta operando, o WAIT 
trava o sistema até o acionamento do RESET. 

Nao disponivel em Integer BASIC. 


WRITE 


Especifica um arquivo em disco para onde as safdas subseqUuentes serao mandadas. 


Formato: 
WRITE nomearg [, Rn}[, Bn] 


Se o arquivo especificado nado esta aberto, ele o é (veja OPEN). As declaracdes PRINT subse- 
quentes mandardo dados no disco até uma declaracdo de disco (ou o caractere CTRL-D (codigo 
ASCII 4) sozinho) seja mandado. Se o arquivo nao estiver no disco, a mensagem FILE NOT 
FOUND aparecera. 

O arquivo sera tratado como sequencial se o pardmetro R estiver ausente. Num arquivo 
sequencial, o pardmetro B especifica em que byte (caractere) o WRITE inicia. Sem o parametro 
B, o WRITE inicia no primeiro byte do arquivo (byte 0). 

Se o pardmetro R esta presente, o arquivo sera gravado como arquivo de acesso aleatorio. 
O WRITE é para o registro especificado pelo pardmetro R. 

Num arquivo de acesso aleatorio, o pardametro B especifica em que byte dentro de um regis- 
tro especificado o WRITE inicia. Sem o pardmetro B, o WRITE inicia no primeiro byte (byte 0) 
do registro. 

O pardmetro B pode ser usado para gravar iniciando num ponto além do Ultimo caractere 
do arquivo (ou registro). Este dado pode ser lido (com READ), porém qualquer tentativa de ler 
bytes intermedidrios nao usados vai gerar a mensagem OUT OF DATA. 

Os nimeros a frente de R e B devem ser inteiros na faixa de 0 até 32767. Se nao especifi- 
cados, 0 é usado. 
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Enquanto WRITE estiver em uso, todo caractere que o Apple II mandaria normalmente 
para a tela sera mandado para o disco. Incluindo pontos de interrogacao gerados por INPUT e as 
mensagens de erro. 

Este 6 um comando DOS, e requer PRINT e CTRL-D em modo programado. 

Nao pode ser usado em modo imediato. 


XDRAW 


Esta declaracado Applesoft desenha uma forma grafica de alta resolucdo na tela e, se usada uma 
segunda vez com os mesmos pardmetros, limpa a forma. 


Formato: 
XDRAW exprnm [AT colh, Linh | 


A forma numero exprnm da tabela de formas é desenhada, com cada ponto na cor que é 0 com- 
plemento da cor da tela no ponto. Cores 0 e 3 sdéo um par complementar, como sdo 1e 2, 4e/7, 
e 5 e 6 (veja Tabela 8.3). A escala e rotacdo da forma deve ser dada pelos comandos COLOR e 
SCALE antes do comando XDRAW ser executado. 

Usa-se XDRAW ao invés de DRAW de forma que se pode facilmente limpar uma forma 
desenhada. Como XDRAW desenha na cor complementar a cor anterior do ponto, se executada 
duas vezes (ou quatro, ou seis), com os mesmos pardmetros, a declaracdo XDRAW, tudo o que 
estiver na tela nado sera alterado. 

Se ndo se especifica uma posicao na declaracdo XDRAW, a forma é desenhada iniciando na 
posi¢do desenhada por ultimo no comando DRAW, XDRAW ou PLOT anterior. Se nao se espe- 
cificar posicao, o desenho inicia naquele ponto (co/h, linh). 

O numero da forma, exprnm, deve ser um valor inteiro entre 0 e o numero de formas da 
tabela (que ndo deve exceder 255), inclusive. 

Nao disponivel em Integer BASIC. 


FUNCOES 


As funcdes do BASIC do Apple II sao descritas abaixo em ordem alfabética. A nomenclatura e 
as abreviacOes sao descritas no inicio deste capitulo. 

Muitas das funcdes sao disponiveis apenas em Applesoft. Estas funcdes sao identificadas 
apropriadamente. 


ABS 


Retorna o valor absoluto de um numero. Isto é, o valor sem sinal. 
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Formato: 


ABS (exprnm) 


ASC 


Retorna o codigo ASCII de um caractere especificado. 


Formato: 
ASC (expr$) 


Se o cordao tem mais de um caractere, o ASC devolve o cédigo do primeiro caractere do cordao. 
O cédigo devolvido nao é necessariamente o menor cddigo (na faixa 0-95) que aquele caractere. 
Os caracteres gerados pelo cédigo ASCII entre 96 e 255 duplicam aqueles da faixa menor na tela. 
Entretanto, eles nado sdo calculados como os mesmos caracteres pelos operadores relacionais como 
<, > e =. Eles devem ser tratados diferentemente para impressoras e outros dispositivos, da 
mesma forma. Se o primeiro caractere da expr$ 6 CTRL-@ (cddigo ASCII 0), a mensagem ?SYN- 
TAX ERROR aparece. Se expr$ é um corddo nulo, a mensagem ?ILLEGAL QUANTITY ERROR 
aparece. 


Os cddigos ASCII sao listados no Apéndice |. 
ATN 
Retorna o arco tangente de um argumento. 


Formato: 


ATN (exprnm) 
Calcula 0 arco tangente, em radianos, de exprnm. O Angulo devolvido esta na faixa entre —7/2 até 
1/2. 
Nao disponivel em Integer BASIC. 


CHRS 


Retorna o valor cordao de um cédigo ASCII especificado. 


Formato: 


CHR$ (exprnm) 


Retorna o caractere representado pelo valor inteiro da expressao exprnm, interpretado como um 
cddigo ASCII. Acha-se a tabela de codigos ASCII no Apéndice |. Use esta funcao para gerar carac- 
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teres que nao se consegue obter a partir do teclado para controle de periféricos etc. O valor de 
exprnm deve estar entre 0 e 255 ou a mensagem ?7ILLEGAL QUANTITY ERROR aparecera. 
Nao disponivel em Integer BASIC. 


COS 


Retorna o cosseno de um Angulo. 


Formato: 


COS (exprnm) 


Calcula o cosseno de exprnm radianos. 
Nao disponivel em Integer BASIC. 


EXP 


Retorna e elevado a uma poténcia. 


Formato: 


EXP (exprnm) 


Calcula e (a base do logaritmo natural: 2,718281828) elevado a poténcia exprnm. 
Nao disponivel em Integer BASIC. 


FN 


Chama uma funcao definida pelo usuario definida anteriormente. 


Formato: 


FN varnm (exprnm) 


varnm € o nome da funcao. O valor da expressdo é adotado sempre que a variavel ficticia aparece 
rra definicao da funcdo, e o resultado da expressdo é calculado. Veja DEF FN na parte de decla- 
racoes neste capitulo. 

Uma funcao nao pode ser recursiva, isto é, exprnm nao pode referenciar FN varnm nem 
outra funcdo que, por sua vez, referencie FN varnm. 

Ao se tentar usar FN varnm antes da definicdo de funcdo DEF FN varnm aparece a mensa- 
gem de erro 7UNDEF’D FUNCTION ERROR. 

Nao disponivel em Integer BASIC. 
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FRE 


Retorna o numero de bytes da memoria presentemente disponivel para o programa BASIC em 
Applesoft. 


Formato: 
FRE (exprnm) 


A memoria disponivel é aquela abaixo da drea de armazenamento de corddes e acima da area de 
armazenamento de arranjos. Existindo mais de 32767 bytes de memoria livres, o FRE devolve um 
numero negativo. Some 65536 ao numero para achar o tamanho real da memoria disponivel. 

O FRE também limpa corddes nao usados da area de armazenamento. Quando um cordao 
troca de valor durante um programa, o valor anterior é deixado na memoria, e o novo valor é 
acrescentado a tabela. Eventualmente isso pode ser danoso, se for usado para outra coisa. Para 
evitar essa operacdo, use a declaracdo A = FRE(0) com alguma frequéncia em programas que 
usam cordoes extensivamente. 

O valor de exprnm néo é usada por FRE, porém causa um erro se ilegal. 

Ndo disponivel em Integer BASIC. 


INT 


Retorna a parte inteira de um numero. 


Formato: 


INT (exprnm) 


Retorna o maior inteiro menor ou igual ao valor de exprnm. 
Nao disponivel em Integer BASIC. 


LEFT$ 


Retorna o caractere mais a esquerda de um cordao. 


Formato: 
LEFT$ (expr$, exprnm) 


Retorna o caractere mais 4 esquerda de expr$. exprnm deve ser um inteiro entre 1 e 255, e expr$ 
nao pode ter mais de 255 caracteres. Se exprnm for maior que o tamanho de expr$, todo o cordao 
é devolvido. 

Nao disponivel em Integer BASIC. 
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LEN 


Retorna o comprimento de um cordao. 


Formato: 
LEN (expr$) 


Conta o numero de caracteres de expr$, incluindo todos os espacos e caracteres nao imprimiveis. 


Se expr$ tem mais de 255 caracteres (possivel apenas se expr$ é produto de concatenacdo de 
cordGdes), a mensagem ?7STRING TOO LONG ERROR aparece. 


LOG 


Retorna o logaritmo natural de um numero. 


Formato: 


LOG (exprnm) 


Calcula o logaritmo natural de exprnm. Retorna ?}LLEGAL QUANTITY ERROR se exprnm é 
zero Ou negativo. 
Nao disponivel em Integer BASIC. 


MID$ 


Retorna a porcdo especificada de um cordao. 


Formato: 
MID (expr$, exprnm, [, exprnm, |) 


Retorna exprnm, caracteres de expr$, iniciando no caractere exprnm,. Se exprnm, estiver ausen- 
te, MID$ retorna a porcao de expr$ a partir do caractere exprnm, até o Ultimo. Se o comprimento 
de expr$ é menor que exprnm,, o cordao nulo é devolvido. Se existem menos que exprnm, carac- 
teres em expr$ apds exprnm,, o resultado 6 o mesmo que se exprnm, estiver ausente. expr$ nao 
deve exceder a 255 caracteres, e exprnm, e exprnm, ambos devem estar entre 1 e 255. 

Nao disponivel em Integer BASIC. 


PDL 


Retorna o valor corrente do controlador de jogo (paddle) especificado. 
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Formato: 


PDL (exprnm) 


O valor retornado é um inteiro entre 0 e 255 baseado na rotacao do padd/e numero exprnm, ou 
da resisténcia do dispositivo conectado ao soquete do controlador de jogo exprnm. Os contro- 
ladores de jogo sdo numerados de 0 a 3. Se for indicado um controlador menor que 0 ou maior 
que 255 a mensagem ?ILLEGAL QUANTITY ERROR 6 gerada. Se o controlador for entre 4 e 
255, o PDL retorna um valor imprevisivel entre 0 e 255, podendo causar varios efeitos colaterais, 
tal como um sinal no alto-falante ou um subito deslocamento no modo grafico. 

Se duas instrucdes PDL sao executadas consecutivamente ou muito proximas, o segundo 
valor pode ser afetado pelo primeiro. Providencie para que varias instrucdes sejam executadas 
entre dois PDL (ou coloque um /oop FOR-NEXT vazio). 


PEEK 


Retorna o valor de uma posicao de memoria. 


Formato: 


PEEK (endmem) 


O valor retornado é 0 equivalente decimal aos oito bits da memoria enderecada por endmem. O 
Apéndice E lista algumas posi¢des de memoria importantes. 


POS 


Retorna a coluna onde o cursor esta posicionado. 


Formato: 


POS (exprnm) 


A expressao é fictfcia; nao 6 usada, podendo ter qualquer valor legal. 

O POS retorna um valor entre 0 e 39. As posicdes iniciam em O para o caractere mais a 
esquerda. 

Nao disponivel em Integer BASIC. 


RIGHTS 


Retorna o caractere mais a direita de um cordao. 
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Formato: 
RIGHTS (expr$, exprnm) 


Retorna o caractere mais a direita do cordao expr$. O valor de exprnm deve ser um inteiro entre 0 
e 255, e expr$ nao pode ter mais de 255 caracteres. Se exprnm é maior ou igual ao comprimento 
de expr$, o cordao inteiro é retornado. 

Nao disponivel em Integer BASIC. 


RND 


Retorna um numero aleatorio. 


Formato: 


RND (exprnm) 


Retorna um numero aleatorio, na faixa que depende do valor de exprnm e da versao do BASIC. 

Em Integer BASIC, o RND retorna um aleatorio entre 0 e o valor de exprnm, exclusive 
exprnm mas inclusive 0. Assim, RND(1) sempre retorna 0, e RND(—2) produz um misto de 0 e 
—1. Ao tentar se usar RND (0) aparece a mensagem de erro *** > 32767 ERR. 

Em Applesoft, RND sempre retorna um nimero real maior ou igual a O e menor que 1. 
O valor retornado pode ser de trés tipos, dependendo do sinal de exprnm. 

Se exprnm é positiva, RND retorna um valor diferente a cada vez que é usado, a menos que 
uma sequéncia repetida tenha sido iniciada. 

Uma seqléncia repetida tem inicio quando exprnm é um nimero negativo. Qualquer valor 
particular sempre inicia a mesma seqUéncia; os argumentos positivos su-hsequentes sempre vdo 
retornar a mesma sequéncia de nimeros aleatorios. Uma sequéncia repetida diferente vai retornar 
para cada valor negativo diferente de exprnm. Esta caracteristica é Util para teste e depuracdao de 
programas que usam RND. 

Se exprnm for 0 em Applesoft, RND retorna o nimero aleatério mais recentemente gerado 
(isso ndo é afetado por NEW ou CLEAR). 


SCRN 


Retorna o cédigo da cor do ponto grafico de baixa resolu¢ao com as coordenadas especificadas. 


Formato: 


SCRN (col, /in) 


Se a tela esté em modo texto, ou a janela de texto esta presente e 0 ponto especificado esta dentro 
dela, o SCRN devolve o cédigo de cor de metade do caractere. O cédigo da cor da metade de cima 
do caractere é devolvida se lin é par, e da metade inferior se lin é fmpar. O codigo ASCII do carac- 
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tere na posicdo (a, b) (com a na faixa de 0-39 e b na faixa de 0-23) é devolvido pela expressdo 
SCRN(a, 2 * b) + 16 * SCRN(a, 2 * 6 + 1). Assim, o caractere é devolvido por CHR$(n), onde n 
é o valor obtido pela expressdo acima. 

Se co/ esta na faixa de 0-39, SCRN retorna o cédigo da cor do ponto grafico (col, /in). 
Se co/ esta na faixa 0-47 e /in na faixa 0-31, SCRN devolve o ponto o numero da cor do ponto 
grafico (co/ —40, /in +16). Se co/ esta na faixa 40-47 e /in na faixa de 32-47, SCRN devolve um 
numero sem relacdo com nada na tela. 

Se SRCN é usado durante o modo grafico de alta resolu¢ao, o numero devolvido esta rela- 
cionado com area de memoria grafica de baixa resolucado em vez de alta resoluc¢ao. 

SRCN so é reconhecida como palavra reservada se o primeiro caractere diferente de espaco 
a sua frente for parénteses. 


SGN 
Determina se um numero é positivo, negativo ou zero. 
Formato: 


SGN (exprnm) 


A funcdo SGN retorna +1 se exprnm é positiva, —1 se é negativa, e 0 se exprnm é 0. 


SIN 


Retorna o seno de um 4ngulo. 


Formato: 


SIN (exprnm) 


Calcula 0 seno de exprnm radianos. 
Nao disponivel em Integer BASIC. 


SPC 


Move o cursor para a direita de um nimero especificado de posic¢odes. 


Formato: 
SPC (exprnm) 


A funcgdo SPC é usada nas declaragdes PRINT para imprimir exprnm espacos em branco. Assim, 
qualquer caractere passado pelo cursor é zerado. 
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A funcao SPC move o cursor para a direita a partir da coluna em que ele estiver no momento 
em que SPC for encontrado. Este 6 um contraste com a funcdo TAB, que move o cursor para 
numeros de coluna fixos a partir da coluna mais a esquerda da tela. 

Nao disponivel em Integer BASIC. 


SQR 


Retorna a raiz quadrada de um numero positivo. 


Formato: 


SOR (exprnm) 


Um valor negativo de exprnm causa a mensagem de erro ?ILLEGAL QUANTITY ERROR. SOR 
(exprnm) opera mais rapidamente que (exprnm) A (.5). 
Nao disponivel em Integer BASIC. 


STR$ 


Converte um valor numérico em cordao. 


Formato: 


STR$ (exprnm) 


O valor de exprnm é convertido em corddo. O corddo de caracteres € o mesmo que se obteria com 

PRINT exprnm. Assim, ST R$ (2/3) = ’’.666666667” e STR$(2468013579) = ’2.46801358E +09”. 

Se exprnm exceder o limite para numeros reais, a mensagem ?OVERFLOW ERROR aparece. 
Nao disponivel em Integer BASIC. 


TAB 


TAB move o cursor para a direita de um numero especificado de colunas. 


Formato: 
TAB (exprnm) 


Use TAB com PRINT para mover o cursor para a coluna exprnm, se exprnm estiver a direita da 
posi¢ao atual do cursor. O cursor ndo se move se a posicdo de tabulacdo estiver 4 sua esquerda 
e em sua posicdo. TAB coloca caracteres em branco durante o movimento do cursor para a direita, 
de forma que zera o que havia previamente na tela. 
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Para TAB, as colunas s€o numeradas de 1 a 255. Se exprnm é maior que o comprimento 
do dispositivo de saida (40 caractere para o video), ele move o cursor uma linha para baixo e con- 
tinua contando a partir da margem esquerda. Se o valor de exprnm é 0, TAB move para a coluna 
256. Um valor de exprnm fora da faixa de 0 a 255 causa a mensagem de erro ?ILLEGAL QUAN- 
TITY ERROR. 

Veja também HTAB (Applesoft) e TAB (Integer BASIC) na parte de declaracdes neste 
capitulo. 

Nao disponivel em Integer BASIC. 


TAN 


Retorna a tangente de um dngulo. 


Formato: 
TAN (exprnm) 


Calcula a tangente de exprnm radianos. 
Nao disponivel em Integer BASIC. 


USR 


Pula para uma sub-rotina em linguagem de maquina, passando os valores pelo Acumulador. 


Formato: 


USR exprnm 


A sub-rotina inicia na posicdo 10 (OA hexadecimal). As posicdes 10 até 12 (OA até OC em hexa- 
decimal) devem conter uma instrucado JMP em linguagem de maquina que salta para o endereco 
inicial da sub-rotina. Como USR é uma funcao, ela retorna um valor real. O que tiver no Acu- 
mulador quando for executada a instrucdo RTS em linguagem de maquina (para retornar ao 
Applesoft) sera o valor retornado. 

Existem muitas sub-rotinas Gteis em linguagem de maquina presente no Monitor do Apple II. 
Elas estado listadas no Apéndice D. 

Veja também a declaracdo CALL descrita na secdo sobre declaracdes neste capitulo, que 
também 6é disponivel em Integer BASIC. 

Nao disponivel em Integer BASIC. 


VAL 


VAL converte um corddo em um valor numérico. 
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Formato: 


VAL (expr$) 


Retorna o valor numérico representado por expr$. Se o primeiro caractere de expr$ nao represen- 
ta um ndmero, zero é devolvido. De outro modo, expr$ é tomado, caractere por caractere, até 
que um Caractere nado aceitavel seja acessado. Os caracteres aceitaveis sao: os digitos de 0 a 9, 
espacos, 0 ponto decimal, os sinais de mais e menos, um outro ponto decimal e a letra E. 

Se expr$ é uma expressdo envolvendo concatenacdo e contém mais de 255 caracteres, a 
mensagem ?STRING TOO LONG ERROR ocorre. Se o valor numérico de expr$ exceder os 
limites de nimeros reais, a mensagem 70VERFLOW ERROR ocorre. 

Nao disponivel em Integer BASIC. 


A 


Funcoes Numeéricas Derivadas 


Mesmo que a relacado de funcdes derivadas abaixo nao seja completa, ela fornece as formulas de 
uso mais frequente. Certos valores de x invalidam algumas funcdes (por exemplo, se COS (x) = 0 
entao SEC(x) nao é real), de forma que o programa deve fazer essas verificag6es. 

Nenhuma das funcdes derivadas operam em Integer BASIC. 


ARCCOS (x) = —ATN (x/SOR (—x «x + 1)) + 1.5707633 
Retorna o cosseno inverso de x (ABS(x) < 1). 


ARCCOT(x) = —ATN(x) + 1.5707633 
Retorna a cotangente inversa de x. 
ARCCOSH(x) = LOG(x + SQR(x * x — 1)) 
Retorna o cosseno hiperbdlico inverso de x (x > = 1). 


ARCCOTH(x) = LOG((x + 1)/(x — 1))/2 
Retorna a cotangente hiperbdlica inversa de x (ABS(x > 1). 


ARCCSC(x) = ATN(1/SQR(x «x — 1)) + (SGN(x) — 1) * 1.5707633 
Retorna a cossecante inversa de x (ABS(x) > 1). 


ARCCSCH(x) = LOG((SGN(x) * SQR(x *x +1) + 1)/x) 
Retorna a cossecante hiperbdlica inversa de x (x > OQ). 


ARCSEC(x) = ATN(SOR(x «x —1)) + (SGN(x) — 1) * 1.5707633 
Retorna a secante inversa de x (ABS(x) > = 1). 


ARCSECH(x) = LOG((SQR(—x * x + 1) + 1)/x) 
Retorna a secante hiperbdlica inversa de x (0 <x <= 1). 
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ARCSIN(x) = ATN(x/SQR(—x * x + 1)) 

Retorna o seno inverso de x (ABS(x) < 1). 
ARCSINH(x) = LOG(x + SOR(x *x + 1)) 

Retorna o seno hiperbdlico inverso de x. 
ARCTANH(x) = LOG((1 + x)/(1 — x))/2 

Retorna a tangente hiperbdlica inversa de x (ABS(x) < 1). 
COSH(x) = (EXP(x) + EXP(—x))/2 

Retorna o cosseno hiperbdlico de x. 
COT(x) = 1/TAN(x) 

Retorna a cotangente de x (x < > 0). 
COTH(x) = EXP(—x)/(EXP(x) — EXP(—x)) * 2+ 1 

Retorna a cotangente hiperbdlica de x (x <> 0). 
CSC(x) = 1/SIN(x) 

Retorna a cossecante de x (x <> 0). 
CSCH(x) = 2/(EXP(x) — EXP(—x)) 

Retorna a cossecante hiperbdlica de x (x <> 0). 
LOG, (x) = LOG(x)/LOG(a) 

Retorna o logaritmo de x na base a (2 > O, x > 0). 
LOG ,, (x) = LOG(x)/2.30258509 

Retorna o logaritmo comum (decimal) de x (x > 0). 
MODa(x) = INT((x/a — INT((x/)) *a + .05) * SGN(x/a) 

Retorna x modulo a: o resto da divisdo de x por a (a < > 0). 
SEC(x) = 1/COS(x) 

Retorna a secante de x (x <> 7/2). 
SECH(x) = 2(EXP(x) + EXP(—x)) 

Retorna a secante hiperbodlica de x. 
SINH(x) = (EXP(x) — EXP(—x))/2 

Retorna o seno hiperbdlico de x. 
TANH(x) = —EXP(—x)/EXP(x) + EXP(—x)) *2 + 1 

Retorna a tangente hiperbdlica de x. 


Comandos de Edicao 


Este apéndice sumariza os comandos de edicado do teclado do Apple II. 
+ Move o cursor para a frente ao longo da linha de edicao. Cada caractere passado 
€ copiado para a memoria como se fosse digitado no teclado. Nao altera a tela. 


<< Move o cursor para tras ao longo da linha de edicao, limpando os caracteres 
pelos quais passa na memoria, porém deixando-os na tela. 


REPT Causa a repeticao da tecla acionada por outra tecla enquanto ambas estado acio- 
nadas. A tecla REPT deve ser acionada apos a outra tecla. 


CTRL-X O Apple II desconsidera a linha digitada e move o cursor para a préxima linha, 
colocando-o na margem esquerda da mesma. 


Sequéncias da Tecla Esc 


Os sete comandos de edicao que seguem sao seqliéncias de duas teclas. Em cada instancia, acione 
a tecla ESC, solte-a, e entao acione a segunda tecla da sequéncia. 


Esc-A Move o cursor uma posicao para a direita. Nao altera a tela nem a memoria. 
Esc-B Move o cursor uma linha para a esquerda. Nao altera a tela nem a memoria. 
Esc-C Move o cursor uma linha para baixo. Nao altera a tela nem a memoria. 

Esc-D Move o cursor uma linha para cima. Nao altera a tela nem a memé6ria. 

Esc-E Limpa todos os caracteres a partir da posicao do cursor até o fim da linha. 
Esc-F Limpa todos os caracteres da posi¢ao do cursor até o fim da tela. 


Esc -@ Limpa a tela e move o cursor para o canto superior esquerdo. 
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Comandos em Modo de Edicao 


Os quatro comandos de edicao seguintes requerem o Monitor Autostart. Eles sio comandos que 
sO Operam no modo de edicao. Entre no modo de edicao acionando a tecla ESC e deixe 0 modo 
de edi¢ao acionando qualquer tecla que nao seja |, J, K, M, REPT, CTRL ou SHIFT. 


Move o cursor uma linha para cima sem sair da edicao. 
Move o cursor uma posicao para a esquerda sem sair da edicao. 


Move o cursor uma linha para a direita sem sair da edicao. 


= A = 


Move o cursor uma linha para baixo sem sair da edicdo. 


C 


Mensagens de Erro 


As mensagens de erro sao agrupadas em trés categorias: Integer BASIC, Applesoft e DOS, e 
sao listadas alfabeticamente dentro de cada categoria. 

As mensagens de erro do DOS e muitas do Applesoft tém cdédigos de erro associados. Apdés 
um erro ter causado um desvio com ONNER GOTO, o céddigo para o erro pode ser obtido na 
posicao de memoria 222. A Tabela C-1, no final deste apéndice, lista as mensagens de erro pelo 
numero de cddigo. 


MENSAGENS DE ERRO DO INTEGER BASIC 


*** > 255 ERR 

O valor que deveria estar entre 0 e 255 esta fora dessa faixa. 
*** > 32767 ERR 

Foi calculado ou digitado um nimero maior que 32767 ou menor que —32767. 
*** 16 FORS ERR 

Foram ativados mais que 16 /oops FOR. 


*** 16 GOSUBS ERR 
Foram executadas dezessete declaracdes GOSUB sem ter sido dado uma declaracao 
RETURN. 


*** BAD BRANCH ERR 
Tentou-se um salto para uma linha inexistente. 


*** BAD NEXT ERR 
Encontrou-se um NEXT sem ter sido dado um FOR anteriormente. 
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*** BAD RETURN ERR 
Executaram-se mais declaracgdes RETURN que declaracdes GOSUB. 


***DIM ERR 
O mesmo arranjo foi dimensionado mais de uma vez. 


*** MEM FULL ERR 
O programa precisa de mais meméria do que existe disponivel. 


*** NO END ERR 
A ultima instrucdo dentro de um programa nao é END. 


*** RANGE ERR 
Foi referenciado um arranjo com subscrito menor que zero ou maior que o seu tamanho, 
ou um argumento numa instrucado HLIN, VLIN, PLOT, TAB ou VTAB foi colocado fora 
da faixa prescrita. 


RETYPE LINE 
Provocou-se um erro em resposta a uma declaracdo INPUT. A mensagem de diagnéstico 
foi mostrada primeiro e depois esta diretiva. 


*** STRING ERR 
Foi detectada uma operacao ilegal com cordao. 


*** STR OVFL ERR 
Foram atribufdos mais caracteres a um cordao do que ele pode aceitar. 


*** SYNTAX ERR 
Ocorreu um erro de digitagao, pontuacao ou seqiiéncia ou outro erro qualquer que nao 
pode ser detectado por outra mensagem. 


*** TOO LONG ERR 
Foram aninhados mais de 12 parénteses ou mais de 128 caracteres dentro de uma linha. 


MENSAGENS DE ERRO DO APPLESOFT 


? BAD SUBSCRIPT ERROR 
Foi referenciado um arranjo com numero errado de subscritos ou com um ou mais subscri- 
tos excedentes em dimensdo. Cédigo de erro 107. 


? CAN’T CONTINUE ERROR 
Foi tentado continuar (com 0 comando CONT) quando nao existe o programa, ou quando 
ocorreu um erro fatal, ou foram feitas mudancas no programa. 


? DIVISION BY ZERO ERROR 
Foi feita uma tentativa de dividir uma expressdo por zero. Cédigo de erro 133. 


? FORMULA TOO COMPLEX ERROR 
Foram executadas mais de duas declaragdes na forma IF cordéo THEN. Cédigo de erro 191. 


? ILLEGAL DIRECT ERROR 
Foi digitado um comando INPUT, DEF FN ou GET em modo imediato. 
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?1ILLEGAL QUANTITY ERROR 
Um valor numérico esta fora da faixa aceitavel para uma funcao com cordao, com valor 
numérico, declaracao grafica etc. Cédigo de erro 53. 


? NEXT WITHOUT FOR ERROR 
Foi executada uma funcao NEXT sem que antes tivesse sido dado o FOR correspondente. 
Um NEXT sem varidvel s6 gera erro se nao existir nenhum FOR em atividade. 


? OUT OF DATA ERROR 
Foi tentado ler mais dados com DATA do que existe disponivel. Codigo de erro 42. 


? OUT OF MEMORY ERROR 
Pode ser causado por: programa muito comprido, muitas varidveis, mais de 10 FOR aninha- 
dos, mais de 24 niveis de sub-rotinas aninhadas, mais de 36 niveis de parénteses aninhados, 
LOMEM: muito alto, ou HIMEM: muito baixo. Cédigo de erro 77. 


? OVERFLOW ERROR 
Foi calculado ou entrado um ndmero muito grande ou muito pequeno. A faixa permitida 
é aproximadamente —1.7E + 38 até 1.7E +38. Cédigo de erro 69. 


? REDIM’D ARRAY ERROR 
Foi achada uma declaragdo DIM para um arranjo j4 dimensionado. Ocorre mais freqiente- 
mente quando um arranjo foi dimensionado por auséncia. Cédigo de erro 120. 


? RETURN WITHOUT GOSUB ERROR 
Foram executadas mais declaracdes RETURN que GOSUB. Cédigo de erro 22. 


?STRING TOO LONG ERROR 
Tentou-se concatenar corddes com total de caracteres excedendo 255. Cédigo de erro 176. 


? SYNTAX ERROR 
Um erro de digitacao, pontuacado ou sequéncia, ou outro erro qualquer onde nao coube 
outra mensagem de erro. Cédigo de erro 16. 


? TYPE MISMATCH ERROR 
Uma expressao numérica ou varidvel foi usada onde deveria ser usado um cordao, ou vice- 
versa. Também ocorre quando os dois lados de uma igualdade nado séo do mesmo tipo. 
Cédigo de erro 163. 


? UNDEF’D FUNCTION ERROR 
Foi referenciada uma funcdo definida por usudrio que nao foi definida. Cédigo de erro 224. 


? UNDEF’D STATEMENT ERROR 
Foi tentado um salto para uma linha de programa inexistente. Cédigo de erro 90. 


MENSAGENS DE ERRO DO DOS 


DISK FULL 
Foi: feita uma tentativa de colocar mais informacao num disco do que ele pode suportar. 
Num disco cheio, esta mensagem pode ocorrer no lugar da informacgao de uma mensagem 
mais apropriada (ex. FILE NOT FOUND). Cédigo de erro 9. 
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TABELA C.1. Céddigos da Erro. 


















0 NEXT sem FOR Applesoft 

1 Linguagem nao disponi/vel DOS 

u3 Erro de faixa DOS 

4 Protegido contra escrita DOS 

5 Fim de dados DOS 

6 Arquivo nao encontrado DOS 

7 Volume nao coincidente DOS 

8 Erro de E/S DOS 

9 Disco cheio DOS 

Arquivo travado DOS 

Erro de sintaxe DOS 

Nao ha buffers disponiveis DOS 

13 Tipo de arquivo nao coincidente DOS 

14 Programa muito comprido DOS 

15 Comando nao direto DOS 
16 Erro de sintaxe Applesoft 
22 RETURN sem GOSUB Applesoft 
42 Fora de DATA Applesoft 
53 Quantidade ilegal Applesoft 
69 Estouro Applesoft 
77 Fora da memoria Applesoft 
90 Declaracao nao definida Applesoft 
107 Subscrito errado Applesoft 
120 Arranjo redimensionado Applesoft 
133 Divisao por zero Applesoft 
163 Tipo nao coincidente Applesoft 
176 Cordao muito longo Applesoft 
191 Formula muito complexa Applesoft 
224 Funcao nado definida Applesoft 
254 Resposta errada a INPUT Applesoft 
255 CTRL-C foi acionado Applesoft 

END OF DATA 


Foi feita uma tentativa de ler uma parte de um arquivo de texto que nunca foi gravado. 


Cédigo de erro 5. 
FILE LOCKED 


Foi feita uma tentativa de usar SAVE, BSAVE, WRITE, DELETE ou RENAME num 


arquivo travado. Cédigo de erro 10. 
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FILE NOT FOUND 
Fez-se referéncia a um arquivo inexistente no disco. Este erro s6 ocorre se o comando DOS 
que referenciou o arquivo nao o criou no momento em que ele nao foi achado. Cédigo 
de erro 6. 


FILE TYPE MISMATCH 
Um comando DOS referenciou um arquivo que nao é do tipo requerido. Os comandos 
LOAD, RUN e SAVE so podem ser usados com arquivos de programas. O comando CHAIN 
s6 pode ser usado com arquivos de programa em Integer BASIC. Os comandos OPEN, 
READ, WRITE, APPEND, POSITION e EXEC so podem ser usados com arquivos de texto. 
Os comandos BLOAD, BSAVE e BRUN so podem ser usados com arquivos binarios. 
Cédigo de erro 13. 

1/0 ERROR 
Tentou-se insatisfatoriamente guardar ou obter informacao de um disco. Algumas causas 
podem ser: a porta do drive esta aberta, o disco nao foi inicializado, nao ha disco no drive, 
ou O disco esta com defeito. Cédigo de erro 8. 


LANGUAGE NOT AVAILABLE 
Tentou-se trocar de linguagem com FP ou INT sem a linguagem desejada estar presente no 
disco ou na ROM, ou foi feita uma tentativa de carregar ou rodar um programa quando 
a linguagem do programa nao era disponfvel. Cédigo de erro 1. 

NO BUFFERS AVAILABLE 
Foi requerido um outro buffer quando todos os buffers disponiveis ja estavam em uso. 
Cédigo de erro 12. 


NOT DIRECT COMMAND 
Os comandos DOS seguintes s6 podem ser usados com o uso de declaracdo PRINT em 
modo programado: APPEND, OPEN, POSITION, READ e WRITE. Codigo de erro 15. 


PROGRAM TOO LARGE 
Um comando DOS tentou ler um arquivo do disco na memoria do Apple II, e nao achou 
memoria suficiente para coloca-lo. Cédigo de erro 14. 


RANGE ERROR 
Um paradmetro usado num comando DOS esta fora da sua faixa especificada; por exemplo, 
oO parametro D (drive) deve ser 1 ou 2. Codigo de erro 2 ou 3. 


SYNTAX ERROR 
Um comando DOS tem um erro de digitacdo, pontuacao ou seqiiéncia. Codigo de erro 11. 


VOLUME MISMATCH 


O pardmetro V (volume) num comando DOS nao coincidiu com o parametro volume do 
disco acessado. Cédigo de erro 7. 


WRITE PROTECTED 
Tentou-se usar SAVE, BSAVE ou WRITE com um arquivo protegido do disco. Cédigo de 
erro 4. 


D 


Sub-rotinas Intrinsecas 


As duas tabelas seguintes listam algumas sub-rotinas em linguagem de maquina disponiveis no 
Apple I! sub-rotina. Ache o ponto de entrada listado na Tabela D.1 na primeira coluna da Tabela 
D.2 para detalhes sobre registradores afetados etc. 

A Tabela D.2 lista as sub-rotinas por ordem de ponto de entrada. A terceira coluna mostra 
Os registradores (se existirem) que deve conter valores especificos antes que a sub-rotina seja 
acessada. A quarta coluna mostra quais registradores sao afetados na execucao da sub-rotina. 

Muitas destas sub-rotinas tém equivalentes em comandos BASIC, ou podem ser acessadas 
a partir do BASIC com uma Unica instrucao CALL. Essas equivaléncias aparecem na Tabela D.2. 
Alguns dos comandos BASIC listados sao disponiveis apenas em Applesoft; eles sao sinalizados 
com um A. 

Algumas sub-rotinas, entretanto, nado tém equivaléncias em nenhuma versao do BASIC, e 
nao podem ser executadas por um CALL porque um ou mais registradores devem ser carregados 
com valores especificos antes de sua execucao. Sado requeridas técnicas diferentes para lidar com 
esse problema, de acordo com a versao do BASIC. 

O Integer BASIC fornece uma solucdo mais simples. Primeiro execute um CALL—182 para 
colocar os valores correntes dos registradores na memoria RAM. Entao dé um POKE nos valores 
desejados nas posicdes de memoria 69 para o registrador’A, 70 para o registrador X e 71 para o 
registrador Y. Execute um CALL—193 para colocar esses valores nos registradores, e dé um 
CALL para a rotina que sera executada em primeiro lugar. 

Esta técnica nao funciona em Applesoft. Deve-se, entao escrever e executar uma sub-rotina 
em linguagem de mdquina que carregue os registradores com os valores desejados e entao execute 
um salto para o ponto de entrada da rotina desejada, em linguagem de mdquina. 
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TABELA D.1. Referéncia a Sub-rotinas Intrinsecas por Funcao. 





Graficos 
de Baixa 
Resolucao 


Entrada 


Saida 


Saida 
de Sino 








Desenha um ponto grafico em baixa resolucao 

Desenha uma linha horizontal em grafico de baixa 
resolucao 

Desenha uma linha vertical em baixa resolucao 

Coloca todas as 48 linhas graficas de baixa resolucao 
em preto (se em modo texto, coloca ‘’@”’ invertido) 

Coloca as 40 linhas de cima de grafico de baixa 
resolucdo em preto (ou ‘‘@” inverso) 

Incrementa a cor do grafico de baixa resolucdao atual 
em trés 

Determina a cor do grafico em baixa resolucao 

Lé a cor de um ponto grafico de baixa resolucao 

Entra no modo grafico de baixa resolucdo, limpa a 

tela e deixa as quatro linhas de baixo para janela 

de texto 
























Espera por acionamento de tecla com o cursor pis- 
cando, e cria o gerador de numeros aleatérios nas 
posicdes $4E e $4F 

O mesmo que acima a excecao que os cddigos de 
escape também sao permitidos 

Manda carriage return para a tela, e permite entrada 

de uma linha inteira de até 256 caracteres 











Manda trés brancos para o dispositivo selecionado 
corrente 

Manda de 1 a 256 brancos para o dispositivo selecio- 
nado corrente 

Manda um carriage return e um /ine feed para a tela 
do Apple II 

Manda um caractere para o dispositivo selecionado 
corrente 

Manda um caractere para a janela de texto 












Manda o caractere de sino (céddigo ASCII 07) para o 
dispositivo selecionado corrente 

Apita no falante interno por 1/10 segundo 

Manda a mensagem ERR e apita o falante interno 

Apita o falante interno 
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TABELA D.1. (continuacao) 


Janela de Pde a tela do Apple II com 24 linhas e 40 colunas $FB2F 
Texto Pula uma linha na janela de texto $FC70 
Manda um caractere backspace para a tela, atuali- 
zando a posicao do cursor 
Move o cursor uma linha para cima. Se o cursor ja 
estiver em cima, ele nado se movera 
Move o cursor uma linha abaixo sem trocar sua po- 


sigao horizontal. Toda a tela salta uma linha se o 
cursor ja estiver na de baixo 




























Controle 
de 
Cursor 







Limpa a janela de texto a partir de sua posicao atual 
até o canto inferior direito da tela 

Limpa a janela de texto das coordenadas passadas no 
registrador até o canto inferior direito da tela 

Limpa toda a tela e move o cursor para 0 canto supe- 
rior esquerdo 

Limpa a linha atual da posi¢do do cursor até o fim 
da linha 


Modo Coloca a tela em video inverso (preto-sobre-branco) 
Video Coloca a tela em video normal (branco-sobre-preto) 


Imprime o conteddo dos registradores Y e X (no for- 
mato YYXX) no dispositivo selecionado corrente 




















$FE80 
$FE84 

















Impressdo ; 5 
P Imprime o contetdo dos registradores A e X (no for- 
de z ee : 

Conteiide mato AAXX) no dispositivo selecionado corrente 
a Imprime o contetdo do registrador X no dispositivo 


selecionado corrente 
Imprime o contetdo do registrador A no dispositivo 
selecionado corrente 


Registradores 

















Recoloca o contetdo dos registradores (valido apenas 
se a rotina intrinseca em $FF4A foi executada pre- 
viamente) 

Salva os contetidos dos registradores nas posicdes 

reservadas da pagina Zero 





Move 
Contetidos 
de 
Registradores 













Lé o estado de um controlador de jogo (paddle) 

Executa um /oop de atraso 

Retorna para o BASIC, eliminando o programa e 
as varidveis da memoria 

Ponto de entrada do Monitor 



















Ponto 
de 


$F800 


$F819 


$F828 


$F832 


$F836 


$F85F 


$F864 
$F871 


$F940 


$F941 
$F944 


$F948 


$F94A 


$FBIE 


Entrada 


TABELA D.2. Sub-rotinas Intrfnsecas por Ponto de Entrada 








Desenha um ponto na 
pagina grdéfica de baixa 
resolucao 1 

Desenha uma linha 

horizontal em baixa 

resolucao 









Desenha uma linha vertical 
em baixa resolucéo 


































Coloca todas as 48 linhas 


em preto (se estiver no 
modo texto, enche de 
caracteres ‘’@"’) 

Limpa as linhas graficas de 
baixa resolucao, deixando 
a janela de texto intacta 

Incrementa a cor do grafico 
de baixa resolucado atual 
em trés 

Determina a cor grafica de 
baixa resolucado 

Lé a cor de um ponto 
grafico de baixa resolucao 

Imprime os conteddos dos 
registradores Y e X (no 
formato Y YXX) na tela 
Ou em outro dispositivo 
selecionado 

Imprime os registradores 
(AAXX) como acima 

iImprime o conteddo do 
registrador X 

Manda trés brancos para o 
dispositivo selecionado 
corrente (determinado 
pelo contetido de CSW) 

Manda de 1 a 256 caracteres 

brancos para 0 dispositivo 

selecionado corrente 





Lé o estado do paddle 
0,1,20u3 


graficas de baixa resolucao 
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Registradores a 
Serem Carregados 
Antes da Chamada 






Coloque linha em 
Aecolunaem Y 















Linha em A, coluna 
em Y, coluna da 
direita na posicao 
de meméoria 44 

Coluna em Y, linha 
em A, linha mais 
baixa na posicao 
de memoria 45 

Nenhum 



















Nenhum 






Nenhum 









Numéro dacoremA 








Linha em A, coluna 
em Y 
Nenhum 












Nenhum 






Nenhum 






Nenhum 












Ndmero de espacos 
em branco em A 
(carregando 0 
imprime 256 
caracteres) 

Numero do paddle 

em X 















Registradores 
Afetados 


Nenhum 


A,Y 


Nenhum 


A 
A (contém namero 


da cor) 
Nenhum 


Nenhum 
Nenhum 


Nenhum 


Nenhum 


0 a FF no registrador 
Y,e contetdo de A 


destruido 











Equivalentes 
BASIC 


PLOT 


HLIN 


VLIN 


CALL-1998 


GR 
(veja $F B40) 


CALL-1953 


COLOR 
SCRN 


CALL-1728 


CALL-1727 
CALL-1724 


CALL-1720 


spc ()A 
CALL-1718 


PDL() 
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TABELA D.2. (continuacdao) 





Ponto Registradores a : 
Registradores 
de Serem Carregados Rivietes 

Entrada Antes da Chamada — 
$FB2F Formada a tela do Apple || Nenhum A 

para 40 linhas de 

24 colunas 
$F B40 Formada a tela para grafico | Nenhum A, Y 


de baixa resolucao, limpa 
a tela e coloca 4 linhas 
para janela de texto 
$FBD9 Manda o caractere BELL Nenhum A,Y 
(cédigo ASCII 07) para o 
dispositivo selecionado 


corrente 

$FBE4 Apita o falante do Apple I| | Nenhum A, Y 
por 1/10 segundo 

$FC10 Manda um caractere Nenhum A 


backspace para a tela, 
atualizando a posicdao do 
! cursor 
| $FCIA Move o cursor uma linha Nenhum A 
para cima. Se ele ja estiver 
na linha superior, nada 
acontece 
$FC42 Limpa a janela de texto Nenhum A; ¥ 
da posicao atual do cursor 
até o canto inferior 
direto da tela 
$FC46 Limpa a janela de texto a Coluna em Y, linha A,Y 
partir das coordenadas em A 
passadas nos registradores 
| até o canto inferior direito 
$FC58 Limpa toda a tela de texto Nenhum A, Y 
| € move 0 cursor para O 
canto superior esquerdo 
| 


$FC62 Manda um carriage return Nenhum 
e um /ine feed para a tela 
do Apple II 
$FC66 Move o cursor uma linha Nenhum A,Y 
















para baixo sem alterar sua 
posicao horizontal. Pula 

toda a tela uma linha para 
cima se estiver na linha de 





baixo 

$FC70 Pula toda a tela uma linha Nenhum A, Y 
para cima 

$FC9C Limpa o texto a partir da Nenhum A,Y 


posicao atual do cursor 
até o fim da linha. A 
posicao do cursor 
permanece inalterada 


Equivalentes 


BASIC 





TEXT 


GR 


CALL-1063 


CALL-1052 


CALL-1008 


CALL-998 


CALL-958 


CALL-954 


HOME4 
CALL-936 


CALL-926 


CALL-922 


CALL-912 


CALL-868 


Ponto 
de 
Entrada 


$FCA8 


$FDOC 


$FD35 


$FD67 


$FDDA 


$FDED 


$FDFO 


$FE80 


$FE84 


$FEBO 


$FF2D 


$FF3A 
$FF3F 


TABELA D.2. (continuacao) 


Executa um /oop de retardo 
que tem 
0.5 (5x2 + 27x + 26) 
de duracao 

Espera por acionamento de 
uma tecla. Gera semente 
de numero aleatdério nas 
posicdes de memoria 78 
e 79 

Como $FDOC, exceto que 
o cédigo escape nao é 
permitido 

Manda carriage return para 
a tela; permite entrada 
de uma linha inteira de 
dados, até 256 caracteres 


Imprime o valor do 
Acumulador como dois 
digitos hexadecimais 

Manda um caractere para 
O dispositivo selecionado 
corrente 

Manda um caractere para 
a janela de texto do 
Apple II 

Coloca 0 video em modo 
reverso (texto preto- 
sobre-branco) 

Coloca 0 video em modo 
normal (texto branco- 
sobre-preto) 

Retorna ao BASIC, 
eliminando o programa 
e as varidveis da 
memédria 

Imprime a mensagem ERR 
e apita o falante interno 

Apita o falante interno 

Recupera 0 contetido dos 
registradores (s6 valido se 
a sub-rotina intrinseca de 
$FF4A foi executada 
previamente) 





Registradores a 





Registradores Equivalentes 
Serem Carregados 
ae eae Afetados BASIC 
Valor do atraso x A CALL-856 
em A 
Nenhum Caractere retorna CALL-756 
em A. 
xe Y 
Nenhum Caractere retorna CALL-715 
em A 
xeY 
Caractere de entrada | Y,A INPUT 
na posicao 51 X contém o tamanho 


da entrada. Os dados 
entrados iniciam na 


posicado $200 

Dado em A A CALL-550 
Caractere em A Nenhum PRINT 
CaractereemA Nenhum PRINT 
Nenhum Y INVERSEA 

CALL-384 
Nenhum Y NORMAL4 

CALL-380 
Nenhum A: X% ¥ CALL-336 
Nenhum A CALL-211 
Nenhum A CALL-198 
Nenhum O contetdo dos CALL-193 


registradores é tirado 
das seguintes posi- 
¢6es: registrador A: 
69($45), registrador 
S: 72($48), registra- 
dor X: 70($46), 
Apontador de Pilha: 
73($49) , registrador 
Y: 71($47) 
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Ponto 


de 
Entrada 


$FF4A 


$FF69 


A 
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TABELA D.2. (continuacao) 


Registradores a 
Uso Serem Carregados 
Antes da Chamada 


Registradores 
Afetados 


Salva os contetdos dos Nenhum Nenhum 
registradores nas posicdes 
da Pagina reservada 0: 
registrador A: 69($45), 
registrador S: 72($48), 
registrador X: 70($46), 
Apontador de Pilha: 
73($49), 
registrador Y: 71($47) 
Ponto de entrada do Nenhum Nenhum 
Monitor 


denota comandos disponiveis apenas em Applesoft. 


Equivalentes 
BASIC 


CALL-182 


CALL-151 


E 


Posicées Uteis de Peek e Poke 


Cada uma das posic6es e memoria listadas abaixo é expressa em termos de um numero decimal 
menor que 32767 em modulo. As posicdes de memoria cima de 32767 sao expressas em termos de 
um ndamero negativo. Existe um numero positivo que se refere 4 mesma posicao de memoria. Some 
65536 ao numero listado para obter o positivo equivalente (exemplo, 65535 — 16384 = 49152). 

Algumas das func¢6des descritas abaixo sdo atuadas com o seu acesso. Quer dizer que a qualquer 
momento em que um PEEK acessar uma posicao especifica de memoria, a operacdo especificada 
tem inicio. Um POKE para a posicao especifica de memoria também dispara a acdo, mas devido a 
caracteristicas do microprocessador do Apple II, uma declaragdo POKE na verdade dispara a acao 
por duas vezes. Neste caso, POKE equivale a duas declaracdes PEEK. Normalmente isso nao faz 
diferenca, mas em casos como —16336 (apita o alto-falante) faz. O valor colocado na memoria 
pelo POKE 6 irrelevante nestas atuacdes sobre enderecos. 


JANELAS DE TEXTO E POSICOES DE CONTROLE DE CURSOR 


32 | Margem Esquerda da Janela de Texto 
Especifica a coluna da margem esquerda da janela de texto. Um PEEK retorna um valor 
entre 0 e 39, como sendo o lado esquerdo da tela. A troca dessa posi¢ao nao afeta a lar- 
gura da janela; ambas as margens, esquerda e direita, se movem. 

Usando um valor maior que 39 no POKE, ou se o valor da posi¢ao mais a largura da 
janela de texto exceder 40, alguns ou mesmo todos os dados mandados para a tela serdo 
colocados fora de sua area de memoria. Isso pode destruir o programa ou mesmo algum 
dado essencial. 


33 Largura da Janela de Texto 
Especifica a Jargura da janela de texto. O valor desta posicado deve estar entre 1 e 40. A 
troca desse valor muda a margem direita para a coluna especificada, onde esta especifi- 


336 


34 


35 


36 


37 
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cado o numero de caracteres especificado 4 frente da margem esquerda (posicao de 
memoria 32). 

Um valor zero nesta posicao (ou seja, largura zero) pode destruir o interpretador 
BASIC. Colocando-se um valor maior que 40 nesta posicao com POKE, ou se o valor 
deste local mais a posi¢ao 32 (margem esquerda) exceder 40, algum ou todo o dado man- 
dado para a tela caira fora de sua drea de memoria. Isso podera destruir o programa ou 
dados importantes. 


Margem Superior da Janela de Texto 


Especifica a margem superior da janela de texto. O valor desta posicao deve estar na faixa 
de O até 23; O especifica a linha superior da tela, 23 a inferior. Colocando-se um valor 
maior que 23 nessa posicado com POKE, algum ou todo o dado mandado para a tela ira 
para areas de memoria fora da area de tela, mexendo com outros dados que podem ser 
importantes. Nao coloque a margem superior do texto abaixo da margem inferior. 


Margem Inferior da Janela de Texto 


Especifica a margem inferior da janela de texto. O valor desta posicdo deve estar na faixa 
entre 0 e 23; O especifica a linha superior da tela e 23 a inferior. Colocando um valor 
maior que 23 nessa posicdo, algum ou todo o dado mandado para a tela podera cair fora 
da area de memoria de video, alterando dados que podem ser importantes. Nao coloque a 
margem inferior da janela de texto acima da margem superior. 


Posi¢ao Horizontal do Cursor 


Especifica a posicao horizontal corrente do cursor. Um PEEK retorna um valor entre 0e 
39 que especifica a posi¢do do cursor em relacdo a margem esquerda da janela de texto 
(nado necessariamente a margem esquerda da tela). Esta posi¢do pode ser usada para posi- 
cionar além da margem direita (e depois imprimi-la com PRINT), mas o cursor fica 1a 
apenas o necessdrio para imprimir um caractere. Nao coloque um valor nesta posicao que 
somado ao da margem esquerda da tela (posicao 32) exceda 39. 

Este PEEK é equivalente a4 funcado POS do Applesoft. 


Posicdo Vertical do Cursor 


Especifica a posicao vertical corrente do cursor. Um PEEK retorna um valor entre 0 e 23, 
em relacdo a linha superior da tela (ndo em relacdo a linha superior da janela de texto}. 
Nao coloque um valor maior que 23 nesta posicdo. 


POSICOES DE TRATAMENTO DE ERRO 


216 


218 


posicGes especificam o numero da linha na qual o errc ocorreu. Este nGmero de linha é 
PEEK (219) * 256 + PEEK (218). 


Indicacao de Erro 

Indica quando um ONNER GOTO esta atuando. Se o bit 7 desta posicdo de memoria é 1 
(ou seja, se a posi¢ado tem um valor 128 ou mais), uma declaracgdo ONNER GOTO foi encon- 
trada, e o controle passara para a linha de nimero especificado no caso de erro. Coloque um 
valor menor que 128 na posicado com POKE para inibir a operacdo de ONNER GOTO. 


e 219 N&mero de Linha Acessada por Erro 
Quando um erro provoca um salto de acordo com uma declaracdo ONNER GOTO, essas 
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222 Codigo de Tipo de Erro 
Especifica que tipo de erro ocorreu. Os cddigos de erro e suas especificagdes sao dados no 
Apéndice C. 


POSICOES DE TECLADO 


— 16384 Caractere do Teclado 
Lé o teclado. Se o valor desta posicao é maior que 127 (ou seja, se o bit 7 esta em 1), uma 
tecla foi acionada. Determine o cédigo ASCII equivalente subtraindo 128 desse valor. 


— 13368 Indicacdo de Teclado 
Desliga o inibidor de teclado (bit 7 da posic¢do — 16384), colocando-o em zero de forma que 
O proximo caractere possa ser lido. 


POSICOES DE SAIDA DE “CLICK” 


— 16352 Click do cassette 
Gera um click auditivo no conector do cassette. 


— 16336 Click do falante 
Gera um click no alto-falante interno. 


CHAVES DE DISPLAY 


As posicées de memoria listadas nesta se¢do ativam certas chaves que determinam as caracteristicas 
de display. Elas ndo sao chaves reais; apenas os comandos PEEK e POKE afetam essas posicoes. 


Graficos Tela cheia Pagina 1 Baixa resolucao 
—16304 —16302 —16300 —1 6298 


Graficos Pdgina 2 Alta resolucao 
mais texto —16299 —16297 
—16301 





FIGURA E.1. Posigdes de Texto e Graficos para PEEK e POKE. 
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Existem quatro chaves, e cada uma delas pode ser colocada em duas posicdes diferentes, como 
mostrado na Figura E.1. Como modo texto selecionado, a Unica chave que tem efeito é a de 
Pagina 1/Pagina 2. 
16304 Selecdo de Modo Grdafico 
Seleciona o modo grafico. A tela grafica nado é colocada em preto. O modo grafico pode ser 
de alta ou baixa resolucdo, pagina 1 ou 2, grafico de tela cheia ou misto de grafico e texto. 
Essas caracteristicas sdo determinadas por outras posicdes de memoria. 


— 16303 Selecdo de Modo Texto 
Seleciona modo texto. O texto pode ser na pagina 1 ou 2, o que é determinado por outras 
posig¢des de memoria. 


— 16302 Seleciona Graficos em Tela Cheia 
Seleciona graficos em tela cheia. Se a tela estiver em modo texto, isto nao ser visivel até que 
a posi¢ao — 16304 seja acessada. 


- 16301 Seleciona Graficos mais Texto 
Determina quatro linhas para janela de texto na parte de baixo da tela. Se a tela estiver no 
modo texto, isto ndo sera visivel até que a posi¢do — 16304 seja acessada. 


— 16300 Seleciona Pagina de Tela 1 
Seleciona pagina 1 de graficos ou texto. 


— 16299 Seleciona Pagina de Tela 2 
Seleciona pagina 2 de grdficos ou texto. 


— 16298 Seleciona Graficos em Baixa Resolucdo 
Seleciona graficos em baixa resolucdo. Se a tela estiver em modo texto, isto nao sera visivel 
até que a posi¢do — 16304 seja acessada. 


— 16297 Seleciona Graficos em Alta Resolucdo 
Seleciona graficos em alta resolucdo. Se a tela estiver em modo texto, isto nao sera visivel 
até que acesse a posicao — 16304. 


POSICOES DE CONTROLE DE JOGOS 


As posicd6es de memoria nesta secdo ligam e desligam os controles de saida de jogos, sentem se 
um botdo foi acionado ou nao, e atuam um liberador de safda. A Figura E.2 mostra como as 
safdas dos controladores de jogos sao manipuladas. 

Todas as entradas e safdas para estas declaracdes PEEK e POKE ligadas ao conector de con- 
trole de jogos sdo mostradas na Figura E.3. 


— 16296 Anunciador 0 Desligado 
Desliga a safda do controlador de jogo (anunciador) numero O. A tensao no pino 15 do 
conector do controlador é colocada em aproximadamente 0 volts (nivel TTL alto). 


— 16295 Anunciador 0 Ligado 
Liga a safda do controlador de jogo (anunciador) numero O. A tensao do pino 15 do conec- 
tor do controlador é colocada em aproximadamente +5 volts (nivel TTL baixo). 
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Ligado 
—16295 


Y 


Desligado Desligado Desligado Desligado 
—16296 —16294 —16292 —16290 
Anunciador O Anunciador 1 Anunciador 2 Anunciador 3 





FIGURA E.2. Manipulacaéo de Saidas de Controlador de Jogo (Anunciadores). 


E/S de Jogo 


Liberador 


Botdo 2 
Botao 1 
Botdo O 


OoO0O000000 
O0O000000 





FIGURA E.3. Entradas e Safdas do Controlador de Jogo. 


— 16294 Anunciador 1 Desligado 
Desliga a saida do controlador de jogo (anunciador) numero 1. A tensao no pino 15 do 
conector do controlador é colocada em aproximadamente 0 volts (nivel TTL alto). 


— 16293 Anunciador 1 Ligado 
Liga a saida do controlador de jogo (anunciador) n&mero 1. A tensao no pino 715 do conec- 
tor do controlador é colocada em aproximadamente +5 volts (nivel TTL baixo). 

— 16292 Anunciador 2 Desligado 
Desliga a safda do controlador de jogo (anunciador) numero 2. A tensdéo no pino 15 do 
conector do controlador é colocada em aproximadamente 0 volts (nivel TTL alto). 
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16291 Anunciador 2 Ligado 
Liga a safda do controlador de jogo (anunciador) ndmero 2. A tensdo no pino 15 do conec- 
tor do controlador é colocada em aproximadamente + 5 volts (nivel TTL baixo). 


16290 Anunciador 3 Desligado 
Desliga a safda do controlador de jogo (anunciador) numero 3. A tensdo no pino 15 do 
conector do controlador é colocada em aproximadamente 0 volts (nivel TTL alto). 


16289 Anunciador 3 Ligado 
Liga a safda do controlador de jogo (anunciador) numero 3. A tensao no pino 15 do conec- 
tor do controlador é colocada em aproximadamente + 5 volts (nivel TTL baixo). 


16287 Ler Botado 0 
Quando o botdo do controlador de jogo numero O é acionado, o valor desta posicao excede 
127; quando nao é acionado, o valor 6 127 ou menos. O botdo 0 é conectado ao pino 2 do 
conector do controlador de jogo. 


16286 Ler Botdo 1 
Quando o botdo do controlador de jogo numero 1 é acionado, o valor desta posicao excede 
127; quando nao é acionado, o valor é 127 ou menos. O botdo 1 é conectado ao pino 3 do 
conector do controlador de jogo. 


16285 Ler Botdo 2 
Quando o botao do controlador de jogo numero 2 é acionado, o valor desta posi¢ao excede 
127; quando nao é acionado, o valor 6 127 ou menos. O botdo 2 é conectado ao pino 4 do 
conector do controlador de jogo. 


16272 Liberador de Saida 
Normalmente o pino 5 do conector do controlador de jogo esta em +5 volts. Se for dado 


um PEEK na posicao de memoria — 16285, ele pula para O volts por um e meio micros- 
segundo. Um POKE aciona o liberador por duas vezes. 


E 


Palavras Reservadas do Basic 


O Apple II interpreta toda ocorréncia das seguintes palavras reservadas como comandos, declara- 
¢des ou funcdes do BASIC. A Unica excecdo é quando elas sao parte de um cordao de texto entre 
aspas. Nao use estas palavras reservadas como varidveis. Cuidado principalmente com as palavras 
reservadas pequenas. 

Pode-se digitar as palavras intervaladas de espa¢os; o Apple II os despreza. 


INTEGER BASIC 


ABS END LET PDL SAVE 
AND FOR LIST PEEK SCRN 
ASC GOSUB LOAD PLOT SGN 
AT GOTO LOMEM: POKE STEP 
AUTO GR MAN POP TAB 
CALL HIMEM: MOD PRINT TERT 
COLOR= HLIN NEW PR# THEN 
CON IF NEXT REM TO 
DEL IN# NOT RETURN TRACE 
DIM INPUT NOTRACE RND VLIN 
DSP LEN OR RUN VTAB 
APPLESOFT 


As palavras reservadas em Applesoft sdo codificadas; cada palavra usa apenas um byte de armazena- 
mento do programa. Os cédigos sao listados em conjunto com suas palavras reservadas. Eles tam- 
bém sdo listados na ordem numérica no Apéndice |. 
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O Applesoft ndo reconhece de acordo a palavra reservada TO se:. 
1. O primeiro caractere diferente de branco antes do TO sejaa letra A, e 


2. Um ou mais brancos separem o T do O. 


ABS (212) HTAB (150) REM (178) 
AND (205) IF (173) RESTORE (174) 
ASC (230) IN + (139) RESUME (166) 
AT (197) INPUT (132) RETURN (177) 
ATN (225) INT (211) RIGHT$ (233) 
CALL (140) INVERSE (158) RND (219) 
CHR$ (231) LEFT$ (232) ROT= (152) 
CLEAR (189) LEN (227) RUN (172) 
COLOR= (160) LET (170) SAVE (183) 
CONT (187) LIST (188) SCALE= (153) 
COS (222) LOAD (182) SCRN( (215) 
DATA (131) LOG (220) SGN (210) 
DEF (184) LOMEM: (164) SHLOAD (154) 
DEL (133) MID$ (234) SIN (223) 
DIM (134) NEW (191) SPC( (195) 
END (128) NEXT (130) SPEED= (169) 
EXP (221) NORMAL (157) SQR (218) 
FLASH (159) NOT (198) STEP (199) 
FN (194) NOTRACE (156) STOP (179) 
FOR (129) ON (180) STORE (168) 
FRE (214) ONERR (165) STR$ (228) 
GET (190) OR (206) TAB( (192) 
GOSUB (176) PDL (216) TAN (224) 
GOTO (171) PEEK (226) TEXT (137) 
GR (136) PLOT (141) THEN (196) 
HCOLOR= (146) POKE (185) TO (193) 
HGR (145) POP (161) TRACE (155) 
HGR2 (144) POS (217) USR (213) 
HIMEM: (163) PRINT (186) VAL (229) 
HLIN (142) PR+ (138) VLIN (143) 
HOME (151) READ (135) VTAB (162) 
HPLOT (147) RECALL (167) WAIT (181) 


XDRAW (149) 


DOS 


Os comandos do DOS s6 sao considerados como palavras reservadas se usados em modo imediato 
ou numa declaragdo PRINT que inicie com o caractere CTRL-D (cédigo ASCII 04). 


APPEND 
BLOAD 
BRUN 
BSAVE 
CHAIN 


CLOSE 
DELETE 
EXEC 
INIT 
LOAD 
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LOCK 
MAXFILES 
MON 
NOMON 
OPEN 


POSITION 
READ 
RENAME 
RUN 
SAVE 


UNLOCK 
VERIFY 
WRITE 


G 


Uso da Memoria 


ORGANIZACAO GERAL DA MEMORIA 


A meméria do Apple I! é dividida em trés categorias gerais: memoria de leitura e gravacdo (tam- 
bém chamada de memoria de acesso aleatorio ou RAM), memoria apenas de leitura (ROM) e posi- 
¢des de entrada/saida (E/S). As posig¢des de memoria de 0 a 49151 (SBFFF hexadecimal) sao de 
RAM, as posicdes de 49152 ($COO0) a 53247 (SCFFF) sAo em ROM. Seu sistema nao precisa 
necessariamente ter todas essas posicdes. Por exemplo, tendo apenas 16K de RAM, as 
posicdes de 16384 ($4000) até 49151 (SBFFF) nao sao usadas. 

A Tabela G.1 mostra como a memoria é alocada no sistema do Apple II. Veja que existem 
dois blocos de posicdes de memoria livres, entre as duas paginas graficas de alta resolucdo. O apon- 
tador do sistema LOMEM: mantém o controle do limite inferior desta area livre, e o apontador do 
sistema HIMEM: marca o limite superior. A memdéria RAM pode ser usada para varias coisas. Entre 
elas esta o interpretador Applesoft nado firmware (do cassette ou disco), o Sistema Operacional em 
Disco (DOS), graficos em alta resolucdo e seu programa e varidveis em BASIC. 


OS INTERPRETADORES DE LINGUAGEM BASIC 


Pode-se ver na Tabela G.1 que o interpretador Integer BASIC sempre reside em ROM. O interpre- 
tador Applesoft também reside em ROM se o sistema tem o cartao Applesoft Firmware ou 0 Car- 
tao Language System instalado. De outra forma, o interpretador Applesoft ocupa aproximada- 
mente 10K bytes de memoria iniciando em 2048 ($800). 
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TABELA G.1. Organizacaéo da Memoria no BASIC. 


Posi¢ao 


Decimal 


0-255 
256-511 
512-767 
768 -1023 

1024-2047 
2048 -3071 
3072-8191 
8192-16383 
16384 -24575 
24576-49151 
49152-49279 
49280 -49407 
49408-51199 
51200-53247 
53248 -65535 


= 


$0-$0FF 
$100-$1FF 
$200-$2FF 
$300 -$3FF 
$400-$7FF 
$800 -$BFF 
$COO-$1F FF 
$2000 -$3F FF 
$4000-$5FFF 
$6000 -$BFFF 
$C000 -$CO7F 
$C080 -$COFF 
$C100-$C7FF 
$C800-$CFFF 


Programas do sistema 
Pilha do sistema 
Buffer de entrada do teclado 


Posicdes dos vetores do Monitor 
Pdgina 1 de texto e grdficos em baixa resolucao 
Pagina 2 de texto e grdficos em baixa resolucao 


Livre 

Pagina grdfica de alta resolucao 1 

Pagina grdafica de alta resolucao 2 

Livre 

Posicdes internas especiais 

Espaco dos cart6es periféricos de E/S 
Memiéria dos cart6es periféricos 

Expansdo de meméria dos cartes periféricos 
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$D000-$FFFF Integer BASIC, Applesoft, o Monitor ou Autostart 


Monitor etc. 





REQUISITOS DE MEMORIA DO DOS 


Precisa-se no minimo de 16K de memoria para usar o DOS. Quando carregado, o DOS usa aproxi- 
madamente os 10K de cima da memoria. HIMEM: é alterado para indicar imediatamente abaixo 
da memoria usada pelo DOS. A Figura G.1 mostra como cada parte da memoria é usada pelo 


Legenda 


cm Interpretador Applesoft 
nao Firmware 


FZ Pagina Grafica de 
Alta Resolucao 1 


RS Pagina Grafica de 
Alta Resolucao 2 


[- ~~] Sistema 


Bytes de Memoria 


DOS (usa 10.752 bytes) 


= Espaco livre 


16K 20K 24K 32K 36K 48K 


Tamanho do Sistema 





FIGURA G.1. Uso da Memoria RAM. 


346 APPLE II 


: Endereco RAM mais alto (HIMEM:) 
0 carregamento 


Oo carregamento 


oe 
re 


* Na versao de 13 setores 





FIGURA G.2. Uso da Memoria Durante o Carregamento. 


DOS em varios tamanhos de sistemas. Veja também que se deve ter no minimo 24K de RAM para 
suportar o DOS junto com Applesoft em disco (ou cassette), e no minimo 32K para usar a pagina 
1 de grafico em alta resolucdo com o DOS. A Figura G.1 mostra claramente 0 conflito existente 
entre o Applesoft em disco ou cassette e a pagina grafica de alta resoluc¢ao 1. 

O DOS usa varias partes adicionais da memoria enquanto esta sendo carregado (veja na 
Figura G.2). Qualquer coisa presente nessas areas antes do carregamento estara perdida depois dele. 


USO DE MEMORIA DO INTEGER BASIC 


Os programas em Integer BASIC residem na parte mais alta da memoria RAM, iniciando em 
HIMEM:. Como mostrado na Figura G.3, HIMEM: é ajustado automaticamente quando se adi- 
ciona, altera ou elimina linhas de programa. 

As variaveis sao guardadas iniciando em LOMEM: e locadas para cima. Na medida em que 
os requisitos de armazenamento de varidveis aumentam, o LOMEM: é ajustado automaticamente. 
Cada varidvel numérica é mapeada na memoria com quatro atributos: nome, o byte DSP (ligado/ 
desligado), a posicdo de memoria da proxima variavel e o valor ou valores da variavel. 

O nome de uma variavel pode ter até 100 caracteres de comprimento. Cada caractere é repre- 
sentado na memoria por um cédigo ASCII, com o bit de maior ordem em 1. 

O byte DSP indica se o comando DSP esta atuante para a variavel. Este byte, normalmente 
em 0, é colocado em 1 quando o DSP é executado para aquela varidvel, e colocado em Q quando 
NO DSP é executado. 

O endereco da préxima varidvel 6 guardado em dois bytes, com o de menor ordem primeiro. 

Os dados sao guardados em pares de bytes, com o byte de menor ordem primeiro. Se a varia- 
vel nado é um arranjo, existe apenas um desses pares. Se ela é arranjo, existe um par por elemento, 
listados na ordem iniciando com elemento zero. Nao existe distincao entre uma variavel simples 
e€ um arranjo com o mesmo nome; a variavel simples é o elemento zero de um arranjo. 
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" Este endereco pode ser achado nas 
Linhas do programa posicdes 76 e 77 (HIMEM:) 
crescem para 
baixo 


Este endereco pode ser achado nas 
_ Armazenamento de posicdes 204 e 205 (LOMEM:) 
varidveis crescem 
para cima 





FIGURA G.3. Mapa de Memoria de Programa em Integer BASIC. 


As varidveis cordao sdo guardadas de forma semelhante. O nome da variavel, o byte DSP, e 
o endereco da proxima variavel sfo guardados da mesma forma que os valores numéricos. O codigo 
ASCII para cada caractere do cordaéo usa um byte, com o bit de maior ordem colocado em 1. 
O ultimo caractere do corddo é seguido por um byte terminador de cordao, no qual o bit de maior 
ordem é 0. 


USO DE MEMORIA NO APPLESOFT 


As linhas de programa do Applesoft ocupam a parte inferior da memoria RAM livre iniciando em 
LOMEM:, como mostrado na Figura G.4. Quando se adiciona, altera ou elimina as linhas de pro- 
grama, LOMEM: é ajustado automaticarnente. As varidveis numéricas simples e apontadores de 
corddo sdo guardados diretamente acima das linhas de programa. Arranjos e apontadores de 
arranjos tipo cordao sao guardados acima das variaveis simples. Os valores dos cord6es sao guar- 
dados no alto da memoria, iniciando em HIMEM:. Usando mais variaveis tipo cordao, HIMEM: 
ajusta-se automaticamente para baixo. 

Cada variavel numérica ‘’e’’ apontador de cordado usa sete bytes de memoria. Cada variavel 
real usa dois codigos ASCII (dois bytes) para o nome da variavel (ambos com o bit de maior ordem 
em 1). O valor é guardado em notacdo cientifica com um byte para o expoente e quatro para a 
mantissa. Esses bytes da mantissa estado na ordem do mais significativo para o menos. 

Cada varidvel inteira também usa dois codigos ASCII (dois bytes) para o nome da variavel 
(ambos com o bit de maior ordem em 1) e dois bytes para o valor da variavel, com o byte de 
maior ordem primeiro. 

Cada apontador de cordado usa dois caracteres ASCII (dois bytes) para o nome da variavel 
(o bit de maior ordem em 1, e o segundo em 0), um byte para o comprimento do cordao, e dois 
bytes para o endereco do valor do cordao, byte de menor ordem primeiro. Os ultimos trés bytes 
de uma variavel inteira e os dois Ultimos de um apontador de cordao nao sao usados. 

Arranjos numéricos e arranjos de apontadores de cord6Oes sao guardados imediatamente 
acima das variaveis. O nome da varidvel € guardado como um codigo ASCII nos dois primeiros 
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Montagem dos cord6es 
para baixo 


Apontadores dos cordées e 
apontadores de varidveis 


Varidveis simples e 
apontadores de cord6ées 


Linhas de programa 
colocam o LOMEM: para cima 





FIGURA G.4. Mapa de Memoria para Programas em Applesoft. 


bytes; ambos os bits de maior ordem para varidveis reais sio 0, ambos sdo 1 para variaveis inteiras, 
€ O primeiro é 1 e o segundo O para apontadores de cordGes. 

O nome da varidvel é seguido por dois bytes que indicam a posicdo da préxima variavel. Isso 
é dado em relacdo ao primeiro byte do nome da varidvel, byte de menor ordem primeiro. A seguir 
vem um byte para o numero de dimens6es, e dois bytes para cada dimensdo (maior ordem primei- 
ro) indicando o tamanho de cada dimensdo. Os tamanhos sdo listados em ordem inversa, ou seja, 
o tamanho da ultima dimensao é dado primeiro. 

Cada elemento de um arranjo é entdo listado, do elemento (0, 0,...,0) ao elemento (N, N, 
...,N). Os elementos sdéo guardados na ordem, com o [ndice mais da esquerda incrementado pri- 
meiro. Cada elemento de um arranjo real usa cinco bytes, um para o expoente, e quatro (mais 
significativo primeiro) para a mantissa. Cada elemento inteiro usa dois bytes, maior ordem pri- 
meiro. Cada elemento apontador de corddo usa trés bytes, um para 0 comprimento do corddo e 
dois (menor ordem primeiro) para o endereco do cordao. 

Os valores dos cord6es s4o guardados na parte mais alta da memoria RAM. Eles requerem um 
byte de memoria para cada caractere. Os corddes duplicados sao guardados apenas uma vez; dois 
ou mais apontadores de corddo podem apontar uma posicdo. A medida em que novos cordées vao 
sendo criados, sdo colocados nas préximas posicdes disponiveis (HIMEM: ajustado para baixo). 
Os corddes que nao estao sendo usados ficam na memoria. A funcdo FRE elimina a ‘’colecao de 
detritos’’ eliminando todos os cord6es abandonados e reajustando o HIMEM:. 


H 


Formato do Disk Il 


A informacaéo é guardada no disquette em 35 bandas concéntricas chamadas trilhas. Essas trilhas 
sao numeradas de O a 34 ($0 até $22). Cada trilha é dividida em 16 segmentos chamados setores, 
numerados de 0 até 15 ($0 até $F). Cada setor pode guardar até 256 bytes de dados. O DOS 
reserva trés trilhas (48 setores) para ele mesmo, e uma trilha (16 setores) para o diretdério do dis- 
quette. Isso deixa 31 trilhas (496 setores) para arquivos de dados e de programas. 

O DOS transfere dados de e para o disco um setor por vez. Ele usa dois buffers de arquivo na 
memoria, um para leitura e outro para gravacao, para cada arquivo ativo. 

Cada tipo de texto (texto, programa e bindrio) tem seu proprio formato no disco. Os textos 
sao gravados em cdédigos ASCII, um byte por caractere. Um byte zero marca o fim do arquivo. 
Todos os bytes de um arquivo de texto sao interpretados como texto. 

Os primeiros dois bytes do primeiro setor de um arquivo de programa BASIC indica 0 com- 
primento do programa, com o byte de menor ordem primeiro. O resto do arquivo contém o pro- 
grama em cédigo ASCI!. Num arquivo em Applesoft, as palavras reservadas sao codificadas ao invés 
de guardadas inteiras (um cédigo é um byte em cddigo ASCII). Veja no Apéndice F a lista de cédi- 
gos em ordem alfabética e no Apéndice | a lista em ordem numérica. 

Os primeiros dois bytes do primeiro setor de um arquivo binario mostra o endereco inicial 
dos dados bindrios na meméria RAM, com o byte de menor ordem primeiro. Os dois bytes seguin- 
tes dio o comprimento do arquivo, com o byte de menor ordem primeiro. O resto do arquivo 
contém os dados binarios. 


A LISTA DE TRILHA/SETOR 


O DOS normalmente grava no disco onde quer que ele ache um setor livre. Isso quer dizer que 
num arquivo de muitos setores, o arquivo fica espalhado entre varias trilhas. O DOS faz uma lista 
de numeros de trilhas e setores usados para cada arquivo e a guarda num ou mais setores adicionais 
no disquette. Esta é chamada lista de trilha/setor. 
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Cada setor da lista contém um apontador para o proximo setor da lista (se existir) e aponta 
para até 122 setores que o arquivo pode conter. 

Um setor de dados nao usado nao é gravado no disquette. Em seu lugar, 0 apontador para 
ele na lista de trilha/setor é 0, isso diz ao DOS para nao procurar dados naquele setor. Além disso, 
o ultimo setor da lista 6 aquele com o apontador para o Ultimo setor de dados. Assim, se o registro 
numero 5000 é o primeiro e Unico registro num arquivo de acesso aleatorio que tem o parametro L 
de 256 (um registro por setor), 42 setores serdo usados. O dado no registro 5000 usa um setor. 
A lista de trilha/setor usa os outros 41 setores (122 ponteiros por setor vezes 41 setores é igual a 
5002 apontadores de registro). Todos os apontadores serdo zero exceto o do registro 5000. 

O byte 0 e os bytes de 3 a 12 do setor da lista de trilha/setor ndo s4o usados. Os bytes 1 e 2 
contém o numero da trilha e os numeros dos setores, respectivamente, do proximo setor da lista. 
Se esses bytes forem ambos zero, este sera o Ultimo setor da lista. 


O DIRETORIO 


O DOS usa a trilha 17 ($11) para o diretorio do disquette. Para cada arquivo, o diretorio contém 
O nome, o tipo, o numero de setores ocupados por ele (mddulo 256) e a posicdo da lista de trilha/ 
setor. Muitas dessas informacdes sdo mostradas com o comando CATALOG. 

Cada setor do diretorio contém informacao de um a sete arquivos. O diretorio inicia na 
trilha 17 setor 15. Quando este setor esta cheio, o diretorio continua no setor 14 etc, até o setor 1. 
O diretério pode conter entradas para até 84 arquivos. 

O byte 0 e os bytes 3 até 10 de cada setor de diretdrio nao sdo usados. Os bytes 1 e 2 con- 
tém, respectivamente, os numeros da trilha e do setor seguinte do diretdrio. Se ambos sao 0, este 
é o Ultimo setor do diretdrio. Os bytes de 11 até 255 contém as entradas do diretorio. Cada 
entrada usa 35 bytes; a primeira entrada vai do byte 11 até o 45, a segunda do 46 ao 80 etc. 

As entradas de diretorio sdo escritas no mesmo formato. A Tabela H.1 mostra o contetdo 
de cada entrada. A Tabela H.2 mostra como o tipo de arquivo é codificado em cada entrada. 


TABELA H.1. Formato do Diretorio de Entrada. 












Namero do Byte Contetido do Byte 









Relativo 
0 Numero da trilha na tabela de trilha/setor. Muda para 255 quando o 
| arquivo é eliminado (conteudo formador retiro no byte relativo 34). 
1 Numero de setor da lista de trilha/setor. 
2 | Tipo de arquivo. Veja Tabela H.2. 
3-32 Nome do arquivo, em ASCII. 
Numero de setores usados no arquivo, mdédulo 256. 





Marca de fim. Normalmente 0, mas trocado para o conteudo formador 
do byte relativo 0 quando o arquivo é eliminado. 
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O setor O da trilha 17 nao tem entradas de diretério. Em seu lugar, ele tem informacao de 
identificagdo de estado, descricdo fisica e espaco disponivel do disco. A Tabela H.3 mostra o con- 
tetdo deste importante setor, chamado de Tabela de Volume do Contetido. 


TABELA H.2. Codificacado dos Tipos de Arquivos do Diretorio do Disco. 





0 Arquivo de programa em Integer BASIC se este bit é 1. 
1 Arquivo de programa em Applesoft se este bit é 1. 
2 Arquivo de programa binario se este bit é 1. 
3-6 Reservado para futura expansdo. 
7 Arquivo travado se este bit é 1. 


Se os bits de 0 até 6 forem todos 0, o arquivo é de texto. 


TABELA H.3. Tabela de Volume do Contetido (setor O, trilha 17). 


re 










Byte Descricao 
0 Nao usado. 
1 Ndmero de trilha do primeiro setor do diretorio. 
2 Numero de setor do primeiro setor do diretdrio. 
3 Numero de distribuicao do DOS. 
4-5 Nao usados. 
6 Numero de volume do disquette. 
7-38 Nao usados. 
39 NdGmero maximo de pares trilha/setor possiveis em cada setor da lista 
| de trilha/setor. 
| 40-47 Nao usados. 
48-51 Mascara para o mapa de setores disponiveis. 
52 Ndmero de trilhas por disquette. 
53 Ndmero de setores por disquette. 
54-55 Numero de bytes por setor: byte de menor ordem em 54, maior em 55. 
56-59 | Mapa de setores disponiveis, trilha OQ. 
| 60-63 Mapa de setores disponiveis, trilha 1. 


64-195 
196-255 


Mapas de setores disponiveis, trilhas 2 até 195. 
Nao usados. 
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Cada grupo de quatro bytes do 56 até o 195 da Tabela de Volume do Contetido contém um 
mapa de disponibilidade para uma das trilha do disco. Cada mapa identifica quais setores da trilha 
associada esta em uso e qual esta disponivel. Um bit tem o valor de 0 quando o setor correspon- 
dente esta em uso, e tem o valor 1 quando o setor correspondente esta livre. A Tabela H.4 indica 
quais bytes identificam quais setores. 


TABELA H.4. Mapa de Disponibilidade de Setores. 


Primeiro 


Segundo 


7 
6 
5 
4 
3 
2 
1 
0 
7 
6 
5 
4 
3 
2 
1 


—"-NWHAOOD™N WD OO 


i) 


0 
Terceiro Nao usado 
Quarto Nao usado 





Coédigos de Caracteres Ascii 
e Cdodigos de Palavras Reservadas 
do Applesoft 


A primeira tabela neste apéndice mostra os cédigos ASCII de 1 a 96 e os caracteres que repre- 
sentam. Os cédigos ASCII na faixa de 96 a 127 produzem os mesmos caracteres na tela do Apple I! 
que os cédigos de 32 até 63, embora com outros dispositivos de safda os cédigos de 96 a 127 
produzem letras mindsculas. Nenhuma tecla do teclado do Apple I! produz cédigos de 96 a 127. 

Os cédigos ASCII de 128 a 255 repetem os cédigos de 0 a 127. Nenhuma tecla do Apple II 
produz estes cddigos em Applesoft, embora eles possam ser gerados pelo Monitor e pelo Integer 
BASIC. 

A segunda tabela lista os codigos de palavras reservadas do Applesoft. Cada palavra reservada 
usa apenas um byte na memoria do programa. Cada palavra reservada é representada por um cddi- 
go, na faixa de 128 até 255. Este cédigo substitui a palavra inteira na memoria do Apple II eno 
disco. A lista esté na ordem numérica por cédigo. O Apéndice F contém uma lista de palavras 
reservadas em ordem alfabética. 
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Cédigos de Caracteres ASCII. 


Codigo Caractere da 
Teclagem ASCII Tela Teclagem 
@ 48 0 0 


Crat- 
Crrai-A 
Crai-B 
Crrau-C 
Crar-D 
Crrt-E 
Cra.-F 
Crri-G 
Crat-H or -— 
Crat-| 

Crat-J 

Crri-K 

Crav-L 
Crri-M 
Crri-N 
Crrt-O 
Cra.-P 
Crri-Q 
Crri-R 

Crrat-S 
Crat-T 
Crri-U or —+ 
Cra.-V 
Crrat-W 
Crri-X 
Crai-Y 

Crai-Z 

Esc 

n.d. 
Crrat-SHirt-M 
Crai- “ 

n.d. 

barra espaco 
| 


Cédigo Caractere da 
ASCII Tela 
0 


























(bell) 
(backspace) 





OMNI OA HELWH — 
OANOORWNH — 








" OOAN OOH WDND — 


(linefeed) 

















(carriage return) 



















(forward space) 















(cancela linha) 











FAAS SS CCAADO Vows BS" TVOHBMWOCAg>ewy € p7” 
PEN<XSCCHH BDO VO ZESWAC-TOAMOGS>Oery IA” 






Nota: Some 128 ao cédigo ASCII se gerado por teclagem no Monitor ou no Integer BASIC. 
n.d. = nao disponfvel no teclado do Apple II. 
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Cédigos de Palavras Reservadas do Applesoft. 


Reserved ia se zerven 


END LOMEM: 
FOR ONERR 
NEXT RESUME 
DATA RECALL 
INPUT STORE 
DEL SPEED= 
DIM LET 
READ GOTO 
GR RUN 
TEXT IF 

PR+# RESTORE 
IN+ & 

CALL GOSUB 
PLOT RETURN 
HLIN 

VLIN 

HGR2 

HGR 

HCOLOR= 

HPLOT 

DRAW 

XDRAW 

HTAB 

HOME 

ROT= 

SCALE= 

SHLOAD 

TRACE 

NOTRACE 

NORMAL 

INVERSE 

FLASH 

COLOR= 

POP 

VTAB 

HIMEM: 
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Tabelas de Conversao 


Este apéndice contém as seguintes tabelas de conversdo: 


@ Ndmeros Hexadecimal — Binarios 


@ Numeros Hexadecimal — Decimais Inteiros 


Tabela de Conversdo Hexadecimal Binario 


Use a tabela abaixo para conversdes entre numeros hexadecimais na faixa de 0-OF e binarios na 
faixa 0000-1111. 

Para converter nimeros maiores para hexadecimal, converte-se quatro digitos binarios por 
vez, Operando da direita para a esquerda. Se existirem menos que quatro digitos binarios no 
grupo mais a esquerda, adicione zeros a direita. Aqui esta um exemplo: 


100101, = 00100101, 
Sees =” 

2 5 

_—=_—_ 

2516 


Converta nimeros hexadecimais maiores que OF para binario, um digito por vez. Aqui esta um 


exemplo: 
en 
3 7 
awe foe 
0011 0111 
eee 


001101115 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL INTEIRO 


A tabela abaixo permite conversdo direta entre 
inteiros hexadecimais de O0-FFF e decimais inteiros 
na faixa de 0-4096. Para converséo de numeros 
maiores, os valores da tabela podem ser adiciona- 
dos aos seguintes: 


Hexadecimal Decimal Hexadecimal Decimal 
01 0v0 40% 20 000 131 072 
02 000 8 192 30 000 196 608 
03 000 12 288 40 000 262 144 
04 000 16 384 50 000 327 680 
05 000 20 480 60 000 393 216 
06 000 24 576 70 000 458 752 
07 000 28 672 80 000 524 288 
08 000 3? 768 90 000 589 824 
09 000 36 864 AO 000 655 360 
OA 000 40 960 BO 000 720 896 
OB 000 45 056 CO 000 786 432 
OC 000 49 152 DO 000 851 968 
9D 000 53 248 EO 000 917 504 
OE 000 57 344 FO 000 983 040 
OF 000 61 440 100 000 1 048 576 
10 000 65 536 200 000 2 097 152 
11 000 69 632 300 000 3 145 728 
12 000 73 728 400 000 4 194 304 
13 000 77 824 500 000 5 242 880 
14 000 81 920 600 000 6 291 456 
15 000 86 016 700 000 7 340 032 
16 000 90 112 800 000 8 388 4608 
17 000 94 208 900 000 9 437 184 
18 0CO 98 304 A00 000 10 485 760 
19 000 102 400 BOO 000 11 534 336 
1A 000 106 496 C00 000 12 582 912 
1B 000 110 592 DOO 000 13 631 488 
1C 000 114 688 E00 000 14 680 064 
1D 000 118 784 FOO 000 15 728 640 
1E 000 122 880 1 000 000 16 777 216 
1F 000 126 976 2 000 000 33 554 432 
0 ] 2 3 4 5 6 

00 0000 0001 0002 0003 0004 0005 0006 

01 0016 0017 0018 0019 0020 0021 0022 

02 0032 0033 0034 0035 0036 0037 0038 

03 0048 0049 0050 005) 0052 0053 0054 

04 0064 0065 0066 0067 0068 0069 0070 

05 0080 0081 0082 0083 0084 0085 0086 

06 0096 0097 0098 0099 0100 0101 0102 

07 0112 0113 0114 O115 0116 O117 0118 

08 0128 0129 0130 013) 0132 0133 0134 

09 0144 0145 0146 0147 0148 0149 0150 

OA 0160 0161 0162 0163 0164 0165 0166 

OB 0176 0177 0178 0179 0180 0181 0182 

oc 0192 0193 0194 0195 0196 ©0197 0198 

0D 0208 0209 0210 0211 0212 0213 0214 

OE 0224 0225 0226 0227 0228 0229 0230 


OF | 0240 0241 0242 0243 0244 0245 0246 


0007 
0423 
0039 
0055 


0071 
0087 
0103 
0119 


0135 
0151 
0167 
0183 


0199 
0215 
0231 
0247 


As frac6es hexadecimais podem ser convertidas pa- 

ra frag¢Ges decimais como segue: 

1. Expresse a fragao decimal como um inteiro ve- 
zes 16, onde n é o numero de posicdes deci- 
mais significativas hexadecimais colocadas a 
direita do ponto hexadecimal 


0. CA9BF 316 = CAI BF3;6 X 16° 


2. Ache o equivalente decimal ao inteiro hexa- 
decimal 


CAQ BF316 = 13 278 19510 


3. Muitiplique o decimal equivalente por 16E" 


13 278 195 
X 596 046 448 x 10716 
0.791 442 09619 


As frac6es decimais podem ser convertidas para 
fracdes hexadecimais multiplicando sucessivamente 
a fracao decimal por 16 na base 10. 

Apos cada multiplicagdo, a por¢do inteira é 
removida para formar a fracgao hexadecimal mon- 
tada a direita do ponto hexadecimal. Entretanto, 
desde que é€ usada aritmética decimal para esta 
conversao, a porcdo inteira de cada produto deve 
ser convertida para nUmeros hexadecimais. 

Exemplo: Converter 0.895 base 10 para seu 
equivalente hexadecimal: 


8 7. A B C D E F 
0008 0009 0010 O01) 0012 0013 0U14 0015 
0024 0025 0026 0027 0028 0029 0030 003) 
0040 0041 0042 0043 0044 0045 0046 0047 
0056 0057 0058 0059 0060 0061 0062 0063 
0072 0073 0074 0075 0076 0077 0078 0079 
0088 0089 0090 0091 0092 0093 0794 0095 
0104 0105 0106 0107 0108 0109 0110 O11) 
0120 0121 0122 0123 0124 0125 0126 0127 
0136 0137 0138 0139 0140 0141 0142 0143 
0152 0153 0154 0155 0156 0'57 0158 0159 
0168 0169 0170 0171 0172 0173 0174 0175 
0184 0185 0186 0187 0188 0189-019 0191 
0200 0201 0202 0203 0204 0205 0206 0207 
0216 0217 0218 0219 0226 0221 0222 0223 
0232 0233 0234 0235 0236 0237 0238 0239 
0248 0249 0250 0251 0252 0253 0254 0255 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL (cont.) 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL (cont.) 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL (cont.) 





3072 
3088 
3104 
3120 


3136 
3152 
3168 
3184 


3200 
3216 
3232 
3248 


3264 
3280 
3296 
3312 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL (cont.) 


3073 
3089 
3105 
3121 


3137 
3153 
3169 
3185 


3201 
3217 
3233 
3249 


3265 
328) 
3297 
3313 


3074 
3090 
3106 
3122 


3138 
3154 
3170 
3186 


3202 
3218 
3234 
3250 


3266 
3282 
3298 
3314 


3267 


3299 
3315 


3076 
3092 
3108 
3124 


3140 
3156 
3172 
3188 


3204 
3220 
3236 
3252 


3268 
3284 
3300 
3316 


3077 
3093 
3109 
3125 


3141 
3157 
3173 
3189 


3205 
3221 
3237 
3253 


3269 
3285 
3301 
3317 


3078 
3094 
3110 
3126 


3142 
3158 
3174 
3190 


3206 
3222 
3238 
3254 


3270 
3286 
3302 
3318 


3079 
3095 
3111 
3127 


3143 
3159 
3175 
319) 


3207 
3223 
3239 
3255 


327) 
3287 
3303 
3319 


3080 
3096 
3112 
3128 


3144 
3160 
3176 
3192 


3208 
3224 
3240 
3256 


3272 
3288 
3304 
3320 


3081 
3097 
3113 
3129 


3145 
3161 
3177 
3193 


3209 
3225 
3241 
3257 


3273 
3289 
3305 
3321 


3082 
3098 
3114 
3130 


3146 
3162 
3178 
3194 


3210 
3226 
3242 
3258 


3274 
3290 
3306 
3322 


3083 
3099 
3115 
3131 


3147 
3163 
3179 
3195 


321) 
3227 
3243 
3259 


3275 
3291 
3307 
3323 


3084 
3100 
3116 
3132 


3148 
3164 
3180 
3196 


3212 
3228 
3244 
3260 


3276 
3292 
3308 
3324 


3086 
3102 
3118 
3134 


3150 
3166 
3182 
3198 


3214 
3230 
3246 
3262 


3278 
3294 
3310 
3326 





3087 
3103 
3119 
3135 


3151 
3167 
3183 
3199 


3215 
223) 
3247 
3263 


3279 
3295 
3311 
3327 


361 


362 


3904 
3920 
3936 
3952 


3968 
3984 
4000 
4016 


4032 
4048 
4064 
4080 
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TABELA DE CONVERSAO HEXADECIMAL-DECIMAL (cont.) 


3905 
3921 
3937 
3953 


3969 
3985 
4001 
4017 


4033 
4049 
4065 
408 | 


3907 
3923 
3939 
3955 


3971 
3987 
4003 
4019 


4035 
405] 
4067 
4083 


3908 
3924 
3940 
3956 


3972 
3988 
4004 
4020 


4036 
4052 
4068 
4084 


3909 
3925 
394] 
3957 


3973 
3989 
4005 
4021 


4037 
4053 
4069 
4085 


3910 
3926 
3942 
3958 


3974 
3990 
4006 
4022 


4038 
4054 
4070 
4086 


3911 
3927 
3943 
3959 


3975 
399 | 
4007 
4023 


4039 
4055 
407) 
4087 


3912 
3928 
3944 
3960 


3976 
3992 
4008 
4024 


4040 


4072 
4088 


3913 
3929 
3945 
3961 


3977 
3993 
4009 
4025 


404] 
4057 
4073 
4089 


3914 
3930 
3946 
3962 


3978 
3994 
4010 
4026 


4042 
4058 
4074 
4090 


3915 
3931 
3947 
3963 


3979 
3995 
4011 
4027 


4043 
4059 
4075 
4091 


3916 
3932 
3948 
3964 


3980 
3996 
4012 
4028 


4044 
4060 
4076 
4092 


3917 
3933 
3949 
3965 


398) 
3997 
4013 
4029 


4045 
4061 
4077 
4093 


3918 
3934 
3950 
3966 


3982 
3998 
4014 
4030 


4046 
4062 
4078 
4094 





3919 
3935 
3951 
3967 


3983 
3999 
4015 
403) 


4047 
4063 
4079 
4095 
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Formularios para Desenho na Tela 


Use os formuldrios deste apéndice para projetar o formato da tela. No formulario de tela de texto, 
os nimeros de linhas e colunas iniciam em 1, o que é apropriado para operac¢ao com texto. No 
formulario grafico de baixa resolucdo, os nimeros de linhas e colunas iniciam em 0, assim como os 


comandos graficos de baixa resolucdao. 
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Tela Grafica de Baixa Resolucado 


ABS, 308-09 
Acumulador, 234, 236-37 
Auto-falante, 102, 222 
posicdes de PEEK e POKE, 336 
Anunciadores, controle de jogo, 338-39 
Apontadores de arquivos, 177-80 
movendo, 184, 189 
APPEND, 184, 280. Veja também OPEN 
Applesoft. Veja também Programas 
acesso a programas pelo Monitor, 231 
cédigos de palavras reservadas, 343, 355 
comprimento de linhas de programa, 40 
nomes de varidveis, 61-62 
numeros de linhas, 55 
posicdes de tabulacdo em, 112-13 
reinfcio, 33 
reinfcio via CTRL-Y, 246 
troca para Integer BASIC, 46-47, 191 
uso de memoria, 347-49 
valores numéricos, 37 
virgulas em, 112-13 
Applesoft Firmware, 7 
Aritmética bindria, 245-46 
Arquivos 
acesso aleatério, 185-89 
buffers, 176, 192 
destravando, 173 
diferencas entre Integer BASIC/Applesoft, 181 
disco, 162 
eliminando do disco, 172 
END OF DATA, 181, 184 
EXEC, 189-90 


Indice Analitico 


fechando, 163 
GET, 182 
guardando numeros em, 183 
linguagem de maquina, 194 
posicionando campos, 184, 189 
rebatizando, 173 
separacao de campos, 183 
sequenciais, 175-81 
setores usados, 167 
tipos, 167 
verificando, 174 
Arquivo sequencial 
abrindo, 176-77 
APPEND, 184 
fechando, 176 
gravando em, 177-82 
Arquivos Imagem Bindria. Veja Arquivos, linguagem 
de maquina 
Arranjos 
armazenamento em cassette, 149-150 
dimensionamento, 64-65 
(ndices, 63 
inicializacdo, 144, 152 
nomes, 63 
redimensionamento, 77 
Arredondamento, 59 
ASC, 309 
ASCII, 
cédigos, 354 
programacao de caracteres em, 120-21 
ATN, 309 
Auto, 44, 154, 261 
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BASIC. Veja também Applesoft e Integer BASIC 
acessando, 26 
caractere de entrada, 35 
com linguagem assembler, 226-28 
iniciando, 27, 34-35 
reiniciando, 33 
versdes do, 26, 191 

BLOAD, 195, 220, 240-41, 262 
verificado, 245 

BRUN, 195, 262 

BSAVE, 194, 219, 262-63 
verificando, 245 


CALL, 103, 256, 263. Veja também USR 
Caracteres de entrada, 14 
applesoft, 14 
integer BASIC, 14 
monitor, 14 
Carregamento de programa 
cassette, 27-28 
disco, 28 
Carregando o DOS, 20-25, 46-47 
applesoft, 165 
CTRL-K, CTRL-P, carregando no Monitor, 165 
inicio automatico, 164 
integer BASIC, 165 
salto a partir do Monitor, 164 
Carregando programas. Veja Carregamento de pro- 
gramas 
Carriage return, 90 
como parte de cordao, 121 
Cartao controlador de disco, 7, 164 
Cartdo de interface de comunicacao, 7 
Cartdo de interface de impressora paralela, 7, 146 
Cartdo integer BASIC, 7 
Cartdes. Veja Cartdes de circuito 
Cart6es de circuito 
cartao de interface de impressora paralela, 7 
cartao de interface de impressora serial, 7 
cartao integer BASIC, 7 
Cartéo Language System, 7, 13 
Cartdées Applesoft Firmware, 7 
Cartdes de controle, 6, 7, 104-105 
cart6es de interface de comunicacao, 7 


principal, 3 
Cartées de interface, 104-05 
Cassettes 


com som, 226 

guardando arranjos no, 149-150 
guardando meméria no, 237-38 
guardando programas no, 45-46 
lendo meméria a partir do, 238-39 
manuseio, 18 

protecdo contra gravacao, 19 

tons de referéncia, 238 


CATALOG, 24-25, 166, 167, 263 
CHAIN, 264 
CHR$, 120-121, 148, 309-10 
Chaves de software, 204, 337-38 
CLEAR, 76, 264 
CLOSE, 176-177, 181, 140, 265 
CLR, 76, 154, 264-65 
Cédigos, 355 
Colecdo de lixo, 348 
Color=, 265-66 
Comando DOS nulo, 180 
Compondo linhas de programa, 151 
Comprimento de linha, 147-148 
ajustando impressdo, 147-148 
CON, 94, 154, 266 
Concatenacéo, 66 
Condicionais, 280 
CONT, 94, 266-67 
Constantes, 150-51 
Contador de posicao, 250-54, 257 
Controladores de jogo, 9, 209, 348 
operacao, 102 
posicdes de PEEK e POKE, 338-39 
sensores, 102 
Cor, 199 
complemento, 221 
Cordao nulo, 57 
Cordées 
comparacao, 69 
concatenacao, 66 
cordao nulo, 57 
varidveis, 60, 61 
Corte de permissdo de escrita, 161 
Corte de proibicdo de escrita, 161 
COS, 310 
CTRL, 16 
CTRL-B, 14, 26, 47, 231 
CTRL-C, 28, 33, 44, 95, 191, 230, 231 
CTRL-E, 234, 236-37 
CTRL-K, 164-65 
CTRL-P, 164-65, 245 
carregamentos no Monitor, 22 
CTRL-S, 44, 233 
CTRL-X, 16, 31, 48 
CTRL-Y, 246 
Cursor 
controle, 117-18 
definicao, 13 
determinacdo da posicao horizontal, 116 
determinacdo da posicdo vertical, 117 
efeitos especiais de video, 117-25 
movimentacdo, 51-52 
posicionamento, 117-18 


Data (Dado), 56-58, 76, 154, 267 
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DeclaracGes de atribuicdo, 75 
Declaracdes PRINT, 89, 105, 152, 295-96 
abreviada, 37 
arquivos em disco, 177-80, 183 
comandos DOS, 104-105 
cordées, 106-07, 112-13 
formatando, 114-16 
numéricos como cordées, 144 
pontos e virgulas em, 106-10 
SPC em, 115 
TAB em, 115 
virgulas em, 111-13, 140 
DEF FN. Veja também FN, 154, 267 
DEL, 154, 268 
DELETE, 172-73, 178, 268 
Depuracdo de programas, 152 
Digito de verificacdo, 174, 238-39 
DIM, 77, 269-70 
Discos rfgidos, 155 
Discos. Veja também Disquettes 
buffer, 164 
carregamento, 165-66 
carregando imagem bindario, 240-41 
catdlogo, 24-25 
com som, 225 
diretério, 164, 166 
eliminando programas do, 172-73 
floppy, 156 
inicializacao, 25-26, 162, 170-72 
lista de trilha / setor, 162-63 
LOAD, 168-69 
mini-, 156 
panes, 164 
processos de armazenamento, 164 
processos de armazenamento de dados, 158 
rfgidos, 154 
RUN, 168 
setores, 159 
tabela de formas, 219 
trilhas, 159 
viagens, 170-72 
volume, 169-70 
winchester, 157 
Disk II, 4-5, 20, 155 
Dispositivos periféricos 
entrada pelos, 104-05 
safda para os, 104-05 
Diskette System Master, 20, 22, 24-25, 27, 161, 


166 
Disquettes, Veja também Drives de disco, discos DOS 
buraco de [ndice, 160 
Diskette System Master, 20, 22, 24, 25, 27 
insercdo, 20 
manuseio, 20 


protecdo contra escrita, 161 
setorizados por software, 160 

DOS 
carregando, 20-24, 46-47, 165-66 
modo programado, 104, 105, 146-47 
requisitos de memoria, 345-46 
vers6es do, 24, 162-63, 166 

DRAW, 221, 270 

Drive de disco, 4-5, 155-64 
especificag¢do dos comandos de disco, 167-68 
numero de drive, 167-68 
numero de slot, 167-68 
numero maximo permitido, 168 


Edicdo 17, 31 
adicionando linhas, 48-49 
eliminando caracteres, 51 
eliminando linhas, 48 
inserindo caracteres, 51-52 
limpando até o fim da linha, 52 
limpando até o fim da tela, 52 
modo edicado, 49-50 
sequéncias ESC, 49-50 
trocando caracteres, 50-51 
trocando linhas, 49-53 
Efeitos de video especiais, 117-20 
END, 41, 95, 154, 271 
Enganos. Veja Erros 
Erros 
comando do Monitor, 236 
corrigindo, 31 
corrigindo durante entrada de dados, 1-38 
ESC 17, 51, 52, 53 
ESC @, 31, 48 
Espacos em branco, 56 
Estrada de dados, 105, 121-127 
backspaces, 139-40 
corrigindo erros, 139 
dados validos, 129 
formuldrios, 134 
informacdes ao operador, 139-40 
interativa, 122-25 
marcados, 130, 134, 136, 139-40 
minimizacgao de erros, 121 
organizacdo, 121 
orientacdo de estilo, 125-27 
permitindo mudangas, 125-27 
procurando erros, 127-29, 131, 133-34 
projetando, 129-30 
verificagao de faixa, 126-27 
EXEC, 189-92, 271 
EXP, 310 
Exemplos de programa 
alta resoluc3o em integer BASIC, 209 
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colocacao da janela de texto, 143-44 
definicdo de firma, 215-17 
entrada de janela de texto, 120 
formuldrio de entrada de dados, 134-35 
geracdo de som, 227-28 
linha diagonal em baixa resolucdo, 201 
marcador de fim de arquivo, 260-61 
programa de apresentacado, 170 
repeteco, 125 
safda de som no falante, 226 
som em linguagem assembler, 250 
validacgado de entrada de dados, 131-34 
Exemplo de sub-rotinas 
cabecalho de impressdo de linhas e colunas, 144 
desenho de alta resolucdo em Integer BASIC, 208 
determinagcao de cor em alta resolucao, 207 
entrada de dados numéricos, 126 
entrada de dois caracteres, 131 
entrando dados tipo corddo, 135-36 
limpando pagina grafica de alta resolucdo, 205 
manuseio de erro, 129 
mascara de entrada de dados, 130 
perguntas sim/ndéo, 126 
Express6es, 65 
aritméticas, 67, 68 
booleanas, 70 
reais, 68 | 
relacionais, 68 
ExpressGes aritméticas, 67 
Express6es booleanas, 70 
ExpressGes do tipo misto, 71 
ExpressGes inteiras, 67 
ExpressGes relacionais, 68 


FN, 311. Veja também DEF FN 
FOR, 82, 83, 118, 154, 178, 272-73 
Formas 
carregando tabela de forma, 220 
definicado de fim de forma, 212 
desenhando, 221 
guardando tabela de forma, 219 
limpando, 221 
montando tabelas de forma, 210 
montando vetores por computador, 215 
mudancas de tamanho, 221 
reserva de meméoria para, 217 
rotacdo, 220 
Formatando, 114 
FP, 26, 37,273 
FRE, 151, 311 
Funcdes, 96-101 
— aninhadas, 101 
— cordées, 99 
— definidas por usuario, 100-101 


— do sistema, 100 
— numéricas, 94-95 
Funcées definidas por usudrio, 100, 267 


GET, 93-94, 131, 154, 273-74 
ler arquivos de texto, 182 

GOSUB, 87, 154, 274-75 

GOSUB. Calculado, 87-88 

GOTO, 78-82, 275 

GOTO calculado, 79 

GR, 197, 275 

Graficas 
alta resolucao, 202-23 
baixa resolucao, 196-202 
janela de texto, 198 
tela cheia, 198 

Graficos em alta resolucado 
arquivos em disco com, 194-95 
cores, 206 
desenhando linhas, 207-08 
desenhando pontos, 207-08 
dimensGes de telas, 202 
formas, 209-23 
janela de texto, 204 
integer BASIC, 204-09 
limpando paginas em alta resolucado, 205-06 
mostrando na tela, 203-06 
paginas, 202-03 
requisitos de memérias, 202-03 
reservando memorias, 202-03 
voltando ao mono texto, 205 

Graficos em baixa resolucdo 
cores, 196-97, 199 
desenhando pontos, 199 
determinando a cor da tela, 201 
dimens@6es da tela, 196 
graficos de tela cheia, 198 
janela de texto, 198 
linhas horizontais, 200 
linhas verticais, 200 
paginas, 196-98 

Gravador cassette, 18. Veja também cassettes 
ajustando o volume, 18-20 
conexdo, 4 

Gravador de fita. Veja gravador cassette 


HCOLOR, 206, 276 
HGR, 203-04, 276-77 
alternativas para 0, 204-05 
HGR2, 204, 277 
alternativas para 0, 204-05 
HIMEN:, 103, 154, 203, 217-18, 220, 257, 277-78, 
346, 347-48 
HLIN, 200, 278 
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HOME, 279 

HPLOT, 210, 279 
aiternativas para o, 208 

HTAB, 117, 140, 280 


IF- THEN, 88, 280-81 
Impressoras 
ativando via Monitor, 246 
CHR$ com, 148 
cédigos de controle, 148 
conjunto de caracteres, 147-48 
conectando, 9-11 
formatando, 139 
largura de linhas, 147-48 
programéveis, 147-48 
selecionando para safda, 146 
tamanho de pagina, 147-48 
Imprimindo cabecalho, 114-15 
Imprimindo listagem de programa, 148-49 
IN#, 165, 281 
modo programado, 104-05 
INIT, 170-72, 281 
INPUT, 91, 123-24, 130, 149, 154, 282-83 
Integer BASIC. Veja também BASIC e Programas 
acesso a partir do Monitor, 230-31 
nomes de varidveis, 60 
numeracdo automiatica de linhas, 44-45 
ndmeros de linhas, 55 
posicdes de tabulacdo no, 111 
reiniciando, 33 
trocando por Applesoft, 46-47 
uso de memoria, 345-47 
valores numéricos, 36 
Interface serial, 7, 146 
INVERSE, 118, 178, 284 


Janela de dados, 141-46 
Janela de texto, 119-20 
posigdes de PEEK e POKE, 336-37 


Language System, 22 
carregando DOS, 20-25, 165 
cartao, 7, 13, 18 

LEFT$, 311 

LEN, 312 

LET, 73, 284 

Letras maidsculas, 15-16 

Letras mindsculas, 15-16 

Ligando, 12 

Linguagem assembler 
com BASIC, 103, 256-57 
depuracdo, 252-255 
mini-assembler, 247-251 
programas de listagem, 251-52 


programas em disco, 184-85 
relocacdo, 256-57 
sub-rotinas internas, 255-57 
Linguagens de programacdo, 54-55 
dialetos, 54 
sintaxe, 54 
List, 43, 56, 284-85 
Listando. Veja Listando programas 
LOAD, 27, 154, 285-86 
LOCK, 173, 286 
LOG, 312 
LOMEN:, 103, 154, 203, 257, 286-87, 346 
LOOPS, 80-84, 272, 288 
aninhados, 81-84 
MAN, 44-45, 154, 287 
MAX FILES, 192-93, 287-88 
Meméria 
acesso direto via BASIC, 102 
alterando blocos de, 235 
alterando enderecos simples, 102, 234 
apenas de leitura (ROM), 3-4 
apontador de endereco, 232 
capacidade de, 3-4 
comparando blocos, 243 
de acesso aleatério (RAM), 3-4 
determinando limites, 103, 104 
enderecamento, 102 
especificando em BASIC, 102-03 
examinando palavras, 232 
guardando via BASIC, 194-95, 240 
guardando via Monitor, 237 
leitura/escrita (RAM), 3-4 
locacgao, 257 
movimento de blocos, 195-242 
mapas, 345-48 
preenchendo com um padrao, 240-41, 242 
recuperando via Monitor, 238-39 
verificando gravacdo, 244 
Memoria apenas de leitura. Veja Meméria 
Memoéria de leitura/gravacdo. Veja Memoria 
Mensagem de apresentacdo, 93-94, 125-27 
Mensagens de erro, 30, 38, 323-327 
MID$, 312 
Mini- assembler, 246-51 
acessando, 247 
comandos do Monitor, 247 
contador de posicdo, 248-49 
formato de instrucdo, 148-49 
saindo do, 248 
secdo de exemplos, 250-51 
MOD, 68 
Modo calculador. Veja Modo imediato 
Modo definido. Veja Modo programado 
Modo direto. Veja Modo imediato 
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Modo edicdo, 49-50 
Modo imediato, 35, 154, 258 
Modo indireto. Veja Modo programado 
Modo programado, 35, 40, 258 
comandos DOS, 105-NF, 146-47, 174-75 
restricGes, 154 
Modo texto, desenho em, 293 
Modos de enderecamento, linguagem assembler, 248 
Modulador de RF, 2, 12 
MON, 193, 288 
Monitor, 14, 229-48, 251-256 
acessando, 229 
alteracao de registradores, 236-37 
apontador de endereco, 233-35, 244 
Autostart Monitor, 22, 230 
com som, 224 
comando definido por usuario, 247 
comando de listar, 251-52 
comando de passo, 251-253, 255 
comando GO, 231, 245 
comando trace, 253 
comandos, 236 
contador de posicao, 251-52 
definicGes, 5-6 
exame de registradores, 233 
guardando memo6oria, 237 
ler memoria, 238-39 
monitor padrao, 229 
mover memoria, 240-41 
procedimento para encher meméria, 241 
processo de verificacdo de meméria gravado, 
244-45 
sub-rotinas internas, 255-257, 328 
safdo do, 230 
selecdo de dispositivo de entrada, 246 
selecdo de dispositivo de safda, 246 
verificar memoria, 241-44 
video reverso, 246 
Monitor Autostart,. Veja Monitor 
Monitor de linguagem de maquina. Veja Monitor 
Monitor em linguagem assembler. Veja Monitor 


NEXT, 81, 154, 288-89 

NEW, 41, 154, 288 

NO DSP, 153, 289 

NO TRACE, 152, 290 

NOMON, 193-94, 289-90 

NORMAL, 118, 290 

Notacao cientifica, 58-59 

Numeracdo automatica de linhas, 44-45 

Numero de slot, 3, 6, 7, 146, 168-69 
especificando em comandos de disco, 168 
selecionando, 105-06 

Numero de volume, 169-72 


Numero do drive, 168-69 
Ndmeros, 57-59 
em notacao cientifica, 58-59 
inteiro, 57 
reais, 58 
Nameros aleatérios, 313 
Ndmeros de linha, 41-42, 54, 151 
como enderecos, 55 
Numeros hexadecimais 
aritmética, 246-47 
conversao para decimal, 356-362 


ON-GOSUB, 88, 291-92 
ON-GOTO, 80, 292 
ONNER GOTO, 154, 181, 290-91 
negando, 128 
rotina de manipulacao de erros, 128 
rotina em linguagem de mdquinas para, 291-92 
OPEN. Veja também APPEND, 176, 185, 292 
Operadores 
aritméticos, 65 
booleanos, 65 
cordées, 65 
precedéncia de, 65 
relacionais, 65 
Operadores Idgicos, 70 
Operadores relacionais, 68 


Paddles. Veja Controle de jogo 
Palavras reservadas, 63 
Panes em disco rfgido, 163 
Panes em disco setorizados por software, 163 
Parada de tubulacdo, 111-12 
Parénteses, 66 
PDL, 312-13 
PEEK, 103, 
determinando coluna do cursor, 116 
determinando linha do cursor, 117 
posicdes tteis, 335 
Plot, 199, 293 
em modo texto, 293 
POKE, 103, 257, 294 
com formas, 218, 220 
com graficos, 198, 204-05 
janela de texto, 119-20 
posicdes Uteis, 335 
Ponto e virgula, 106-110, 140 
em arquivos de disco, 183 
separando variaveis, 90 
POP, 86, 134, 294-95 
POS, 116, 313 
PR#, 146, 148-49, 165, 295 
modo programado, 104-05 
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Precedéncia, 65-66 
sobrepassando, 66 
Programa de apresentacdo, 26, 170, 174 
Programas 
adicionando linhas, 43, 48-49 
compactos, 150 
declaracdes, 38 
depuracdo, 151-52 
destravando, 173 
eliminando do disco, 172-73 
eliminando linhas, 48 
entrando espacos em branco, 56 
execucao, 41 
finalizando, 41 
guardando em cassettes, 45-46 
largura de linhas, 36-43 
linhas de mialtiplas declaracdes, 43, 150 
mais rapidos, 149-50 
ndmeros de linhas, 41 
otimizacgao, 149-51 
rebatizando, 173 
sequéncia de linhas, 41-43, 55-56 
trocando linhas, 49-53 
trovados, 173 
verificando, 175 
Programas em linguagem de maquina, 247-57 
Veja também Linguagem Assembler 


RAM. Veja Memoria 

READ, 74, 180-82, 184-85, 189 
arquivo EXEC, 189-90 
declaracao de atribuicao, 297 
declaracdo de disco, 296-97 

RECALL, 149-50 

Recépia. Veja Tecla de flexa para a direita 

Recursdo, 86 

Registrador Apontador de Pilha, 234, 236-37 

Registrador (ndice X, 234, 236-37 

Registrador (ndice Y, 234, 236-37 

Registradores, 256 
alterando, 236-37 
examinando, 233 

REM, 73, 151, 298-99 

RENAME, 173-74, 299 

Requisicdo, declaracado INPUT, 93 

REPT, 17, 31, 48, 53 

RESET, 15, 16, 33, 95, 253 
acidental, 16, 31-33 
recuperacdo por, 33 

RESTORE, 76, 299 

RESUME, 128, 154, 299-300 

RETURN, 154, 300 

RIGHTS, 313-14 
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ROM . Veja Meméria 

ROT, 231, 300 

RND, 314 

RUN 
declaracao de disco, 301 
declaracdo geral, 28, 123, 154, 301 


Safdas 
alinhando valores numéricos, 144 
arranjos, 141 
formatando, 140 
Safdas de programa, 105-21, 139-49 
Salto, 36, 145 
Saltos 
comandos do Monitor, 245 
declaracd6es BASIC, 78-80 
SAVE, 154, 172, 301-02 
SCALE, 221-22, 302 
SCRN, 201, 314-15 
Setores, 159 
hard, 160 
locacao, 160 
SGN, 315 
SHIFT, 16 
SHLOAD, 219-20, 302 
SIN, 315 
Sinal de aspas, com parte de cordao, 121 
Sistema Operacional em Disco. Veja DOS 
Som, 223-28 
com linguagem de maquina, 224, 226 
SPC, 115, 315-16 
SPEED, 118, 303 
SOR, 316 
STOP, 95, 303 
STORE, 149-50, 304 
STR$, 316 
Sub-rotinas 
aninhadas, 86-87 
chamando BASIC, 274, 292 
chamando programa assembler, 263, 317 
entrada de dados, 125-27 
internas, 328-34 
saida com GOTO, 134 
Sub-rotinas intr{nsecas, 328-34 


TAB 
declaracao, 117, 140, 304 
funcdo PRINT, 115, 316-17 

Tabela grdfica, 11 

Tabela verdade, 70 

Tabelas de forma, 210 
apontando para, 220 
carregando, 220 
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codificando bytes, 211-13 
defini¢ado de fim de forma, 212 
diretério, 213 
entrando, 217-19 
guardando, 219 
tamanho, 213 
vetor de desenho zero, 212 
TAN, 317 
Teclado, 1, 15 
desativando via Monitor, 246 
Tecla de flexa para a direita, 17, 31, 49, 51-53 
Tecla Escape. Veja ESC 
Tecla flexa para a esquerda, 17, 31, 53 
Teclas de controle. Veja CTRL 
Teclas de flexa, 17, 31 
Técnicas de visualizacéo, 142 
Tela de TV, 1 
Tela de video 
ajustando a largura, 49-50 
ajuste de cor, 28-30 
aparelho de televisdo, 1, 2 
chaves de software, 337-38 
conex6es, 2 
determinando a cor da tela, 201 
dimensGes da, 2 
evitando a Ultima coluna, 144 
formas em alta resolucdo, 209-23 
formatando, 139 
graficos em alta resolucao, 202-09 
graficos em baixa resolucao, 196-202 
graficos em tela cheia, 198 
janela de dados, 141-46 
limpando, 117 
listando programas, 44 
modo texto, 198 
modo video reverso, 118, 246 
monitor de televisdo, 1, 2 
80 colunas, 9, 13 
operando com, 36, 145 
piscando, 124 
projeto, 140 
velocidade, 118 
Teste de programa. Veja Depuracao de Programa 
TEXT, 304 
TRACE, 152, 305 
com DOS, 194 


Trilhas, 158-59 
locagdo, 160 
Truncagem, 72 
Tipos de programas 
— aplicacdo, 5 
— interpretadores, 5 
— Monitor, 6 
— saudacdo, 25, 170 


UNLOCK, 173, 305 
USR, 257, 321 


VAL, 317-18 
Valores numéricos, impressos como cordG6es, 144 
Varidveis, 150-51 
atribuindo valores, 122-24 
cordées, 60-61 
formato na meméria, 345-46 
inteiros, 61 
nomes, 59, 63 
numéricos, 61 
rascunho, 151 
reais, 62 
Varidveis de (ndice, 80-81 
Varidveis de rascunho, 151 
Varidveis numéricas, 61 
Variaveis reais, 62 
Vetores 
desenho, 210-13 
fantasmas, 210 
Vetores de desenho, 210 
cédigos, 211 
montando vetores por computador, 215 
Vetores fantasmas, 210 
VERIFY, 174, 305-06 
Video reverso, 118, 246 
Virgulas, 111-15, 140 
em arquivo de dados, 181-84 
separando variaveis, 89 
Vlin, 306 
Vtab, 117, 140, 306 


WAIT, 306-07 
WRITE, 177-80, 184-85, 189, 307-08 


XDRAW, 221, 308 
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